Django3：模型与迁移——把博客的数据存进数据库

1. 先写规则，再写字段

设计模型前，先用中文把业务规则写清楚：

1. 一篇文章有一位作者；一位作者可以写多篇文章。
2. 一篇文章最多属于一个分类，也可以暂时不分类。
3. 一篇文章可以有多个标签；一个标签也可以标记多篇文章。
4. 新文章默认是草稿，游客看不到草稿。

把规则翻译成关系：

User（用户）     1 ──── N  Post（文章）
Category（分类） 1 ──── N  Post（文章，可为空）
Post（文章）     N ──── N  Tag（标签）   ← Django 自动建中间表

2. 完整模型代码

保存到 blog/models.py：

from django.conf import settings
from django.db import models
from django.urls import reverse


class Category(models.Model):
    name = models.CharField("名称", max_length=50, unique=True)

    def __str__(self):
        return self.name


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

    def __str__(self):
        return self.name


class Post(models.Model):
    class Status(models.TextChoices):
        DRAFT = "draft", "草稿"
        PUBLISHED = "published", "已发布"

    title = models.CharField("标题", max_length=200)
    slug = models.SlugField("网址标识", max_length=200, unique=True)
    body = models.TextField("正文")
    author = models.ForeignKey(
        settings.AUTH_USER_MODEL, on_delete=models.PROTECT,
        related_name="posts", verbose_name="作者",
    )
    category = models.ForeignKey(
        Category, on_delete=models.SET_NULL, null=True, blank=True,
        related_name="posts", verbose_name="分类",
    )
    tags = models.ManyToManyField(Tag, blank=True, related_name="posts", verbose_name="标签")
    status = models.CharField("状态", max_length=10, choices=Status.choices, default=Status.DRAFT)
    views = models.PositiveIntegerField("阅读计数", default=0)
    created_at = models.DateTimeField("创建时间", auto_now_add=True)
    updated_at = models.DateTimeField("更新时间", auto_now=True)

    class Meta:
        ordering = ["-created_at", "-pk"]
        indexes = [models.Index(fields=["status", "-created_at", "-id"], name="post_status_created_idx")]
        constraints = [models.CheckConstraint(
            condition=models.Q(status__in=["draft", "published"]),
            name="post_status_valid",
        )]

    def __str__(self):
        return self.title

    def get_absolute_url(self):
        return reverse("blog:detail", kwargs={"slug": self.slug})

几个值得注意的地方：

• __str__() 决定对象在后台和调试输出里显示成什么。
• get_absolute_url() 用路由名生成地址，不在模型里写死 /p/。
• Meta.ordering 默认按时间倒序；追加 -pk 让同一时间创建的文章顺序也稳定（分页需要）。
• views（阅读计数） 只用于第 4 篇的并发更新练习，页面不会自动累加它。
• 每条数据库记录还有一个自增的 id（即 pk）。编辑、删除地址用 pk，公开地址用 slug。

3. 容易混淆的字段参数

4. 删除关联对象会发生什么

on_delete 决定被引用的对象删除时怎么办：

related_name="posts" 提供反向查询：user.posts.all() 取某人的全部文章，category.posts.all() 取某分类下的文章。

关联用户时写 settings.AUTH_USER_MODEL 而不是直接导入 User，这样以后换成自定义用户模型也不用改这里（第 7 篇会讨论）。

5. 迁移：把模型变成表

修改 models.py 不会自动改数据库。需要两步：

python manage.py makemigrations blog
python manage.py migrate

完整示例已经自带 0001_initial.py，所以运行 makemigrations 显示 No changes detected 是正常的。执行 migrate 后，showmigrations blog 应显示 [X] 0001_initial。

6. 在 shell 里插入第一篇文章

先确认已用 createsuperuser 创建了名为 admin 的账号（如果用了别的名字，替换下面的用户名）。进入 shell：

python manage.py shell

逐段执行：

from django.contrib.auth import get_user_model
from blog.models import Category, Post, Tag

author = get_user_model().objects.get(username="admin")
category, _ = Category.objects.get_or_create(name="技术")
tag, _ = Tag.objects.get_or_create(name="Django")

post, created = Post.objects.get_or_create(
    slug="first-django-post",
    defaults={
        "title": "我的第一篇 Django 文章",
        "body": "今天完成了数据库模型和迁移。",
        "author": author,
        "category": category,
        "status": Post.Status.PUBLISHED,
    },
)
post.tags.add(tag)
print(post.pk, post.title, post.get_absolute_url())

应该打印出 /p/first-django-post/。

• get_or_create() 找到同 slug 的文章就直接返回它，所以重复执行不会报错，也不会用 defaults 覆盖已有内容。
• tags.add() 必须在文章保存（有了主键）之后调用，因为中间表要引用文章的 id。

7. 修改已有表：给文章加摘要

假设数据库里已经有 100 篇文章，现在要加一个可选的摘要字段：

summary = models.CharField("摘要", max_length=300, blank=True, default="")

python manage.py makemigrations blog
python manage.py migrate --plan
python manage.py migrate

--plan 先预览要执行的操作，确认无误再真正执行。

如果摘要将来必须填写呢？ 不要一步到位加一个“非空且没有默认值”的字段——数据库不知道 100 篇旧文章该填什么。稳妥做法分三步：

1. 先加允许为空的字段；
2. 用数据迁移或脚本给旧文章补上摘要；
3. 确认都有值之后，再收紧为必填。

写数据迁移时，用 apps.get_model("blog", "Post") 获取当时的历史模型，不要直接 from blog.models import Post。

8. 常见报错

小练习