必须用through自定义中间模型，因默认ManyToManyField生成的中间表仅含两个外键字段，无法添加时间、角色、状态等业务字段，且启用through后.add()等方法会被禁用。
直接说结论：复杂 M2M 关系不是靠 ManyToManyField 默认用法能搞定的，必须用 through 自定义中间模型 —— 否则加不了时间、角色、状态等业务字段，也绕不开 .add() 被禁用的坑。
为什么默认 ManyToManyField 一加字段就失效
当你在 Book.authors = models.ManyToManyField(Author) 这种写法下，Django 自动生成中间表（如 book_author），只含两个外键字段：book_id 和 author_id。一旦你试图往关系里塞“入职时间”“编辑角色”“审核状态”这类字段，这条路就断了。
常见错误现象：
- 手动给中间表加字段 → 迁移失败或 ORM 完全无视新字段
- 调用
book.authors.add(author_obj)报错：AttributeError: 'ManyRelatedManager' object has no attribute 'add'（其实是被 Django 主动禁用） - 想查“某作者在某本书里是主编还是审校”，只能写原生 SQL 或硬编码 join，没法用
.filter()
根本原因：Django 认为“带额外字段的关系”已不属于“纯多对多”，而属于“带属性的关联”，必须显式建模。
用 through 模型定义可扩展的 M2M 关系
核心是把中间表变成一个真实模型，并通过 through 和 through_fields 显式绑定。这不是可选项，是唯一能加字段的路径。
实操要点：
- 中间模型必须包含两个
ForeignKey，分别指向两端模型，且on_delete必须明确（推荐models.CASCADE） -
through_fields参数必须传元组，顺序是(当前模型外键字段名, 关联模型外键字段名)，不能反 - 如果需要防止重复关系（比如同一作者不能两次加入同一本书），加
class Meta: unique_together = ('book', 'author')
示例：
class Book(models.Model):
title = models.CharField(max_length=100)
<p>class Author(models.Model):
name = models.CharField(max_length=100)</p><p>class BookAuthor(models.Model):
book = models.ForeignKey(Book, on_delete=models.CASCADE)
author = models.ForeignKey(Author, on_delete=models.CASCADE)
role = models.CharField(max_length=20) # 新增字段：角色
added_at = models.DateTimeField(auto_now_add=True)</p><pre class="brush:php;toolbar:false;">class Meta:
unique_together = ('book', 'author')
class Book(models.Model): title = models.CharField(max_length=100) authors = models.ManyToManyField( Author, through='BookAuthor', through_fields=('book', 'author') )
through 模型下怎么增删查改
不能再用 .add() / .remove()，因为 Django 不知道怎么填 role 或 added_at。所有操作必须走中间模型本身。
- 添加关系：创建
BookAuthor实例，而不是调用book.authors.add() - 查询带属性的关系：
BookAuthor.objects.filter(book=book_obj, role='editor')，不是book.authors.filter(...) - 反向查某作者参与的所有书及其角色：
author.bookauthor_set.all().select_related('book') - 批量添加？用
BookAuthor.objects.bulk_create([...])，别碰.set()或.clear()—— 它们在through模式下无效
容易忽略的点：Django 不会自动帮你处理级联删除逻辑。比如删掉一本书，BookAuthor 行不会自动删（除非你在 ForeignKey 里设 on_delete=models.CASCADE），但 book.authors.all() 会返回空 —— 这是缓存/ORM 层的假象，实际数据还在中间表里。
什么时候该考虑 django-generic-m2m 或手写第三张表
django-generic-m2m 只适合“任意模型之间临时挂关系”的场景（比如标签系统、通用收藏），它用 GenericForeignKey 换取灵活性，代价是丢失外键约束、无法建联合索引、查询性能差、不支持 select_related。
如果你的 M2M 关系有明确业务含义（如“用户-课程-选课状态-成绩”）、需要数据库级完整性、要高频 join 查询，就老实用 through 模型 —— 手写第三张表不是退化，是回归关系型本质。
最常被跳过的一步：在 through 模型里漏加 unique_together，导致同一对记录重复插入；或者忘了在 ForeignKey 上加 db_constraint=True（默认是 True，但有人手动关了），结果数据库没外键约束，脏数据悄无声息。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
