Django 模型（实战总结）

Django 模型：让数据结构化，让开发更高效

在 Django 的世界里，模型（Model）是整个应用的基石。它不仅仅是数据库表的抽象，更是业务逻辑与数据持久化的桥梁。想象一下，如果你要开发一个博客系统，用户写文章、发布评论、管理标签……这些信息都需要被安全、高效地存储。而 Django 模型，就是帮你把“写文章”这个动作背后的数据，变成数据库里可读可写的结构化记录。

Django 模型的核心理念是“模型即代码”，你用 Python 代码定义数据结构，Django 自动帮你生成数据库表。这种“代码驱动数据库”的方式，让开发更直观、更可控，也更容易团队协作。

什么是 Django 模型？从“数据表”说起

在传统 Web 开发中，数据库表是通过 SQL 语句创建的。比如：

CREATE TABLE blog_post (
    id INT PRIMARY KEY AUTO_INCREMENT,
    title VARCHAR(200) NOT NULL,
    content TEXT,
    author VARCHAR(50),
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

而 Django 模型让你用 Python 代码来实现同样的效果。它把数据库表的概念封装成一个类，每个字段对应表的一列。

以博客文章为例，我们创建一个 Post 模型：

from django.db import models

class Post(models.Model):
    # 文章标题，最大长度 200 个字符
    title = models.CharField(max_length=200, verbose_name="文章标题")
    
    # 文章正文，不限制长度
    content = models.TextField(verbose_name="文章内容")
    
    # 作者名称，字符串类型，长度不超过 50
    author = models.CharField(max_length=50, verbose_name="作者")
    
    # 创建时间，自动记录当前时间
    created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
    
    # 更新时间，每次保存时自动更新
    updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
    
    # 为方便在后台管理中显示，设置字符串表示
    def __str__(self):
        return self.title

关键点说明：

• models.Model 是所有模型的基类，继承它才能成为 Django 模型。
• CharField 用于短文本，必须指定 max_length。
• TextField 用于长文本，比如文章正文，不设长度限制。
• DateTimeField 有两个重要参数：auto_now_add=True 表示首次创建时记录时间，auto_now=True 表示每次保存都更新时间。
• __str__ 方法定义了模型对象在 Django 管理后台或调试时的显示名称。

模型字段类型详解：选对类型，事半功倍

Django 提供了丰富的字段类型，覆盖了常见的数据需求。选对字段类型，不仅能保证数据完整性，还能提升查询效率。

实用建议：

• 使用 default 参数为字段设置默认值，避免空值问题。
• null=True 和 blank=True 要搭配使用，前者控制数据库是否允许空值，后者控制表单验证是否允许为空。
• verbose_name 是字段的“友好名称”，在 Django 管理后台中显示，提升可读性。

模型关系：从“一对一”到“多对多”

现实世界中，数据往往不是孤立的。比如一篇文章属于一个作者，一个作者可以写多篇文章；一个文章可以有多个标签，一个标签可以属于多篇文章。这就是模型之间的“关系”。

一对一关系：唯一对应

适合用于扩展基础模型，比如用户信息扩展。

class User(models.Model):
    username = models.CharField(max_length=50)
    email = models.EmailField()

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name="profile")
    bio = models.TextField(blank=True)
    avatar = models.ImageField(upload_to="avatars/", blank=True)

on_delete=models.CASCADE 表示当用户被删除时，其资料也自动删除。

一对多关系：一个对多个

最常见的关系，如作者与文章。

class Author(models.Model):
    name = models.CharField(max_length=50)
    email = models.EmailField()

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name="posts")

related_name="posts" 允许从作者反向查询其所有文章：author.posts.all()

多对多关系：双向关联

适合标签、分类等场景。

class Tag(models.Model):
    name = models.CharField(max_length=30, unique=True)

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    tags = models.ManyToManyField(Tag, related_name="posts")

unique=True 确保标签名称不重复。 可以通过 post.tags.add(tag) 添加标签，post.tags.all() 获取所有标签。

模型的迁移：从代码到数据库的“变身”

当你写完模型代码后，Django 还不知道你想要创建数据库表。这时候需要运行迁移命令，把模型“同步”到数据库。

步骤一：生成迁移文件

python manage.py makemigrations

这条命令会扫描所有应用中的模型变化，生成一个迁移文件，比如 0001_initial.py。它记录了“如何创建表”、“如何添加字段”。

步骤二：应用迁移

python manage.py migrate

这条命令执行迁移文件，真正修改数据库结构。你可以在数据库中看到 blog_post 表已经创建好了。

重要提醒：

• 每次修改模型后，必须重新运行 makemigrations。
• 生产环境迁移前，务必备份数据库。
• 迁移文件是版本控制的一部分，建议提交到 Git。

模型的使用：在视图和模板中操作数据

模型写好了，接下来就是使用它。Django 提供了强大的 ORM（对象关系映射），让你用 Python 代码操作数据库，无需写 SQL。

在视图中查询数据

from django.shortcuts import render
from .models import Post

def post_list(request):
    # 查询所有文章，按创建时间倒序
    posts = Post.objects.all().order_by('-created_at')
    
    # 或者只查已发布的文章
    published_posts = Post.objects.filter(is_published=True).order_by('-created_at')
    
    return render(request, 'blog/list.html', {'posts': posts})

Post.objects 是模型的管理器，提供查询方法。 -created_at 表示按时间倒序，created_at 表示正序。

在模板中展示数据

<!-- blog/list.html -->
<h2>文章列表</h2>
<ul>
{% for post in posts %}
    <li>
        <h3>{{ post.title }}</h3>
        <p>作者：{{ post.author }} | 时间：{{ post.created_at }}</p>
        <p>{{ post.content|truncatewords:30 }}</p>
    </li>
{% endfor %}
</ul>

实践案例：创建一个简单的博客系统

让我们把前面的知识整合起来，快速搭建一个功能完整的博客系统。

1. 创建项目和应用：

django-admin startproject myblog
cd myblog
python manage.py startapp blog

2. 在 blog/models.py 中定义模型：

from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=200, verbose_name="标题")
    content = models.TextField(verbose_name="内容")
    author = models.CharField(max_length=50, verbose_name="作者")
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)
    is_published = models.BooleanField(default=False, verbose_name="是否发布")

    def __str__(self):
        return self.title

3. 生成并应用迁移：

python manage.py makemigrations
python manage.py migrate

4. 在 admin.py 注册模型，启用管理后台：

from django.contrib import admin
from .models import Post

admin.site.register(Post)

5. 启动服务器，访问 http://127.0.0.1:8000/admin，用 superuser 登录，就可以看到你的博客文章管理界面。

总结：掌握 Django 模型，就是掌握数据核心

Django 模型不只是“数据库表的代码表示”，它是一种设计思维——用 Python 代码定义数据结构，用 ORM 操作数据，用迁移管理变化。它让开发者从繁琐的 SQL 语句中解放出来，专注于业务逻辑。

从 CharField 到 ManyToManyField，从 makemigrations 到 objects.all()，每一步都在强化你对数据的理解。当你能熟练定义模型、管理关系、执行迁移、操作数据时，你就真正掌握了 Django 的“数据核心”。

记住：模型是 Django 应用的起点，也是终点。它决定了系统的可维护性、可扩展性和健壮性。花时间把模型设计好，未来你会感谢今天的自己。

Django 模型，不是工具，而是一种开发哲学。学会它，你就离专业开发更近一步。