如何在Django模板中渲染多对多关联的标签集合？

核心问题 #

你的模型中重复定义了多对多关系：Post类里的tag字段和Tag类里的post字段都声明了多对多关联，这会导致Django在数据库中生成两张独立的中间表，你给Post添加的标签实际存储在其中一张表，但模板读取的是另一张表的数据，因此无法渲染出标签。

修复步骤 #

1. 清理重复的多对多字段 #

只需要保留其中一侧的多对多定义即可，推荐保留Post中的tag字段，删除Tag中的post字段（因为Post已经通过related_name='posts'设置了反向关联，Tag仍能通过tag.posts访问关联的文章）。

修改后的模型代码：

class Post(models.Model):
    date = models.DateTimeField(auto_now_add=True)
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name='posts', null=True, blank=True)
    title = models.CharField(max_length=200)
    content = models.TextField(null=True, blank=True)
    image = models.ImageField(upload_to='post/images/', null=True, blank=True)
    slug = models.SlugField(max_length=200, unique=True, null=True, blank=True)
    tag = models.ManyToManyField('Tag', related_name='posts', blank=True)

    def save(self, *args, **kwargs):
        if self.image:
            ext = os.path.splitext(self.image.name)[1]
            filename = f"{datetime.now().strftime('%Y%m%d%H%M%S')}{ext}"
            self.image.name = filename
        if not self.slug:
            self.slug = slugify(self.title)
        return super().save(*args, **kwargs)

class Tag(models.Model):
    name = models.CharField(max_length=200)
    slug = models.SlugField(max_length=200, unique=True, blank=True)

    def save(self, *args, **kwargs):
        if not self.slug:
            self.slug = slugify(self.name)
        return super().save(*args, **kwargs)

    def __str__(self):
        return self.name

2. 更新数据库结构 #

修改模型后，必须执行迁移命令让数据库同步变更：

python manage.py makemigrations
python manage.py migrate

3. 重新关联标签数据 #

如果之前已经给文章添加过标签，需要重新在后台或通过代码关联一次（因为旧数据存储在废弃的中间表中）；如果是新数据，直接添加标签即可。

4. 优化查询（可选） #

为了避免模板渲染时的N+1查询问题，可以在视图中对posts做预加载优化：

posts = Post.objects.prefetch_related('tag').all()  # 预加载关联的标签
context = {
    'posts': posts,
    # 其他上下文内容...
}

模板代码无需修改，{% for tag in post.tag.all %}可以正常遍历关联的标签。

内容的提问来源于stack exchange，提问作者Yuke Dog