在Django的模型设计中，多对多字段常用于表示两个模型之间的多对多关联关系，比如文章和标签、用户和角色等场景。当关联对象存在状态标识，比如隐藏状态时，我们往往需要查询出主对象中，所有关联对象都不处于隐藏状态的记录，或者排除掉存在任意隐藏关联对象的记录，这是实际开发中非常常见的查询需求。
场景模型定义
首先我们先定义两个存在多对多关系的模型，方便后续演示查询逻辑。假设我们有一个Article文章模型，和一个Tag标签模型，文章可以有多个标签，标签也可以属于多篇文章，同时标签有一个is_hidden字段标识是否为隐藏状态。
from django.db import models
class Tag(models.Model):
name = models.CharField(max_length=50, verbose_name="标签名称")
is_hidden = models.BooleanField(default=False, verbose_name="是否隐藏")
def __str__(self):
return self.name
class Article(models.Model):
title = models.CharField(max_length=200, verbose_name="文章标题")
content = models.TextField(verbose_name="文章内容")
tags = models.ManyToManyField(Tag, related_name="articles", verbose_name="文章标签")
def __str__(self):
return self.title
排除存在隐藏关联对象的记录
如果我们需要查询所有文章，要求这些文章的关联标签中不存在任何隐藏状态的标签，也就是只要文章有一个关联标签是隐藏的，就把这篇文章排除掉，可以通过exclude配合多对多字段的关联查询实现。
基础实现方式
Django ORM支持通过双下划线跨模型查询多对多关联字段的属性，我们可以直接在exclude中指定多对多字段关联的隐藏状态条件：
from django.db.models import Q # 排除所有关联了隐藏标签的文章 articles = Article.objects.exclude(tags__is_hidden=True)
这个查询的逻辑是：先找到所有关联了is_hidden=True的标签的文章ID，然后把这些ID对应的文章从查询结果中排除，最终得到的就是所有关联标签都不隐藏的文章。
处理重复记录问题
当文章关联多个标签时，上面的查询可能会出现重复的文章记录，因为多对多查询会为每一个匹配的关联关系返回一条记录。如果需要去重，可以加上distinct()方法：
# 排除关联隐藏标签的文章并去重 articles = Article.objects.exclude(tags__is_hidden=True).distinct()
更复杂的过滤场景
如果我们的过滤条件更复杂，比如需要同时排除关联隐藏标签，还要排除标题为空的文章，可以结合Q对象实现多条件排除：
from django.db.models import Q
# 排除关联隐藏标签 或者 标题为空的文章
articles = Article.objects.exclude(
Q(tags__is_hidden=True) | Q(title="")
).distinct()
反向查询场景
如果我们需要从标签侧查询，排除那些关联了隐藏文章的标签，逻辑是类似的，利用反向关联名称查询即可：
# 假设Article模型有is_hidden字段，排除关联了隐藏文章的标签 tags = Tag.objects.exclude(articles__is_hidden=True).distinct()
查询逻辑验证
我们可以通过Django shell验证查询逻辑是否符合预期，先创建测试数据：
# 创建标签 tag1 = Tag.objects.create(name="Python", is_hidden=False) tag2 = Tag.objects.create(name="Django", is_hidden=True) tag3 = Tag.objects.create(name="ORM", is_hidden=False) # 创建文章 article1 = Article.objects.create(title="Django基础教程", content="Django入门内容") article1.tags.add(tag1, tag3) # 关联两个非隐藏标签 article2 = Article.objects.create(title="Django高级用法", content="Django进阶内容") article2.tags.add(tag1, tag2) # 关联一个隐藏标签 # 执行查询 result = Article.objects.exclude(tags__is_hidden=True).distinct() print([a.title for a in result]) # 输出：['Django基础教程']，符合预期
注意事项
- 多对多字段的跨模型查询会产生关联表的JOIN操作，如果数据量较大，需要注意查询性能，可以适当添加数据库索引。
exclude中的条件如果是多对多关联属性，默认是只要存在一个匹配关联就会排除该主对象，符合我们排除任意关联对象为隐藏状态的需求。- 如果关联对象的状态是动态变化的，查询时需要确保使用的是最新的数据库数据，避免缓存导致结果不准确。
Django多对多字段ORM查询excludehidden_status修改时间：2026-07-15 20:12:32