Django ORM – 多表实例（实战总结）

Django ORM – 多表实例：从零理解模型关系设计

在 Django 开发中，数据库模型的设计是整个项目的基础。当你从单表模型进阶到复杂业务场景时，多表关系就不可避免。Django ORM 提供了强大的关系映射能力，让你可以用 Python 代码优雅地操作数据库，而无需手写 SQL。本文将通过一个完整的“博客系统”案例，带你深入理解 Django ORM 中的多表实例设计与使用。

什么是多表实例？为什么要用它？

简单来说，多表实例指的是多个数据库表之间存在关联关系，比如一篇文章属于一个作者，一个作者可以有多篇文章。这种关系在现实中非常普遍。

想象一下你正在写一个博客平台。如果所有数据都存放在一张表里，比如 post 表包含 title、content、author_name、publish_date 等字段，那么当你要修改作者名字时，必须更新所有相关记录——这不仅效率低，还容易出错。

而通过多表设计，我们将“作者”和“文章”拆分成两个独立的表，通过外键（ForeignKey）建立联系。这样，作者信息只需维护一次，文章引用即可自动关联。

这就是 Django ORM 的优势所在：用 Python 的方式表达数据库关系，既清晰又安全。

创建多表模型：一对多关系实战

我们以“博客系统”为例，构建两个核心模型：Author 和 Post。


from django.db import models

class Author(models.Model):
    name = models.CharField(max_length=100, verbose_name="作者姓名")
    email = models.EmailField(unique=True, verbose_name="邮箱")
    created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")

    def __str__(self):
        return self.name

    class Meta:
        db_table = "authors"
        verbose_name = "作者"
        verbose_name_plural = "作者列表"

class Post(models.Model):
    title = models.CharField(max_length=200, verbose_name="文章标题")
    content = models.TextField(verbose_name="文章内容")
    author = models.ForeignKey(
        Author,
        on_delete=models.CASCADE,
        related_name="posts",
        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

    class Meta:
        db_table = "posts"
        verbose_name = "文章"
        verbose_name_plural = "文章列表"

💡 关键点说明：

ForeignKey 是一对多关系的核心。Post 表中 author 字段指向 Author 表的主键。

on_delete=models.CASCADE 表示当作者被删除时，其所有文章也会被自动删除。这避免了“孤儿数据”。

related_name="posts" 允许我们从 Author 实例反向查询其所有文章，比如 author.posts.all()。

多表查询：从一个作者查出所有文章

有了模型后，我们来实际操作一下。假设你想查看某个作者的所有文章。


from myapp.models import Author

author = Author.objects.get(name="张三")

posts = author.posts.all()

for post in posts:
    print(f"文章标题：{post.title}，发布时间：{post.created_at}")

📌 小贴士：related_name 是 Django ORM 中非常实用的功能。它让反向查询变得直观。如果没有设置，系统默认使用 post_set，比如 author.post_set.all()，但命名不够语义化。

多表关系中的“外键”与“反向查询”

我们再深入一点，来看看外键背后的数据结构。

在数据库层面，Post 表会有一个字段 author_id，它是一个外键，指向 authors 表的主键 id。当你执行 author.posts.all() 时，Django 会自动帮你生成类似这样的 SQL：

SELECT * FROM posts WHERE author_id = 1;

这正是 ORM 的魅力：你写的是 Python 代码，它背后自动转换为高效的 SQL。

但要注意，如果频繁使用反向查询，建议在模型中添加 related_name，否则代码可读性会下降。

多表关联查询：跨表筛选数据

现实场景中，我们常常需要跨表筛选。比如：找出“最近 7 天发布”的文章，且作者邮箱以 @example.com 结尾。

from django.utils import timezone
from myapp.models import Post, Author

recent_posts = Post.objects.filter(
    created_at__gte=timezone.now() - timezone.timedelta(days=7),
    author__email__endswith="@example.com"
).select_related('author')  # 提升性能

for post in recent_posts:
    print(f"{post.title} - 作者：{post.author.name}")

✅ 性能优化提示：使用 select_related('author') 可以在一次数据库查询中加载关联的 Author 数据，避免 N+1 查询问题。这是 Django ORM 中非常重要的优化技巧。

一对一与多对多关系：进阶场景

除了“一对多”，Django 还支持其他两种关系：

一对一关系：一个用户对应一个个人资料

class UserProfile(models.Model):
    user = models.OneToOneField(
        to=Author,
        on_delete=models.CASCADE,
        related_name="profile"
    )
    bio = models.TextField(blank=True, verbose_name="个人简介")
    avatar = models.ImageField(upload_to="avatars/", blank=True)

    def __str__(self):
        return f"{self.user.name} 的资料"

这种关系常用于扩展默认用户模型。比如在 Django 中，User 模型无法直接添加自定义字段，这时可以用 OneToOneField 关联一个 UserProfile。

多对多关系：文章与标签

一个文章可以有多个标签，一个标签也可以属于多篇文章。

class Tag(models.Model):
    name = models.CharField(max_length=50, unique=True, verbose_name="标签名")

    def __str__(self):
        return self.name

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

    def __str__(self):
        return self.title

使用 ManyToManyField 后，Django 会自动创建中间表（如 post_tags），管理文章与标签的关联。

查询某个标签下的所有文章：

tag = Tag.objects.get(name="Python")
posts = tag.posts.all()

for post in posts:
    print(post.title)

数据库迁移与模型同步

在修改模型后，必须执行迁移命令，让数据库结构更新。

python manage.py makemigrations
python manage.py migrate

⚠️ 注意：在生产环境上执行迁移前，务必备份数据库。修改模型结构可能导致数据丢失。

总结：掌握 Django ORM – 多表实例的关键

通过本文的实战案例，我们从零构建了一个完整的多表系统。你已经学会了：

如何定义一对多、一对一、多对多关系；
如何使用 ForeignKey、OneToOneField、ManyToManyField；
如何进行跨表查询与反向查询；
如何通过 select_related 和 prefetch_related 优化性能；
如何使用 related_name 提升代码可读性。

Django ORM – 多表实例不仅是技术能力的体现，更是你设计数据库结构思维的升级。它让你从“写 SQL”转向“用 Python 思考数据”，从而构建更健壮、更易维护的项目。

记住：模型设计得好，后期维护少一半痛苦。从今天起，把多表关系当作你的“数据桥梁”，让每个字段都表达清晰的业务含义。

最后，无论你是初学者还是中级开发者，只要愿意深入理解 Django ORM 的多表机制，你离写出高质量 Web 应用就更近了一步。