manytomanyfield 不能直接存额外字段，因其底层关联表仅含两个外键，无字段扩展空间；必须通过显式定义 through 模型来支持额外字段（如 role、year），并手动操作该模型完成增删查改。
为什么 ManyToManyField 不能直接存额外字段
Django 的 ManyToManyField 底层靠一张纯关联表实现，只存两个外键（比如 book_id 和 author_id），没有预留字段位置。一旦你想记录“张三翻译了这本书”或“2023年推荐”，就必须自己接管这张表——不是加个字段就行，得用 through 模型显式定义。
常见错误现象：AttributeError: 'ManyRelatedManager' object has no attribute 'role'，或者试图在 add() 里传额外参数失败。
- 必须定义独立的
through模型，继承models.Model -
through模型里至少包含两个ForeignKey，分别指向多对多两端的模型 - 原
ManyToManyField必须显式指定through=YourThroughModel，否则 Django 仍用自动生成的隐式表 - 不能同时设
through和through_fields以外的参数（如related_name要写在through模型的ForeignKey上）
怎么定义和使用 through 模型
核心是让中间表变成“可读写”的实体模型，而不是黑盒关联表。比如书和作者之间想存“译者角色”和“合作年份”：
class Book(models.Model):
title = models.CharField(max_length=100)
<p>class Author(models.Model):
name = models.CharField(max_length=50)</p><p>class BookAuthorRelation(models.Model):
book = models.ForeignKey(Book, on_delete=models.CASCADE)
author = models.ForeignKey(Author, on_delete=models.CASCADE)
role = models.CharField(max_length=20) # 如 'translator', 'editor'
year = models.IntegerField()</p><pre class="brush:python;toolbar:false;">class Meta:
unique_together = ('book', 'author')
然后在 Book 或 Author 中声明：
class Book(models.Model):
title = models.CharField(max_length=100)
authors = models.ManyToManyField(
Author,
through='BookAuthorRelation',
through_fields=('book', 'author')
)
-
through_fields必须按顺序写：(本模型外键字段名, 关联模型外键字段名)，顺序错会导致RelatedObjectDoesNotExist -
through模型不能有默认的auto_created行为，必须手动实例化并save() - 不支持
add()/set()直接传额外字段；得先创建BookAuthorRelation实例
增删查改时怎么操作额外字段
所有带额外数据的操作都绕不开 through 模型本身。Django 不会自动帮你填充那些字段，你得亲手管。
- 添加关系 + 额外数据：
BookAuthorRelation.objects.create(book=book, author=author, role='translator', year=2023) - 查询带额外字段的数据：
BookAuthorRelation.objects.filter(book=book).select_related('author')，而不是book.authors.all() - 修改额外字段：
rel = BookAuthorRelation.objects.get(book=book, author=author); rel.role = 'reviewer'; rel.save() - 删除关系：
BookAuthorRelation.objects.filter(book=book, author=author).delete()，不能用book.authors.remove(author)（它只清隐式表）
性能影响：每次查额外字段都要 JOIN through 表，比纯 ManyToManyField 多一次查询开销；如果只查基础关系，用 book.authors.all() 依然高效。
迁移和历史数据怎么处理
已有项目加 through 是破坏性变更。Django 不会自动把旧关联数据迁移到新表，得手动补。
- 先建空
through模型并生成迁移，但别立刻migrate - 写一个数据迁移脚本，从 Django 自动生成的旧关联表（如
book_authors）读出book_id/author_id，批量插入到新BookAuthorRelation表 - 确认数据一致后，再执行迁移；之后所有代码必须切换到
through操作路径 - 如果旧表还有其他应用在读，得协调停用，否则两边数据会不一致
容易被忽略的是反向关系的命名冲突——比如 Author.book_set 还存在，但实际关联逻辑已移交给 BookAuthorRelation，别误以为 author.book_set.all() 还能拿到 role 字段。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
