在Django的ORM查询体系中，Q对象是处理复杂逻辑查询的核心工具，它突破了普通关键字参数查询只能实现AND逻辑的限制，支持OR、NOT等多种逻辑组合，能够满足各类复杂的业务查询需求。
Q对象的基本定义
Q对象来自django.db.models模块，本质是一个查询条件封装类，每一个Q对象实例都代表一个独立的查询条件。我们可以通过导入模块后直接实例化Q对象来定义单个查询条件，示例如下：
from django.db.models import Q from app.models import User # 定义一个查询年龄大于18岁的Q对象 q1 = Q(age__gt=18) # 定义一个查询用户名为admin的Q对象 q2 = Q(username="admin")
使用Q对象实现OR逻辑查询
OR逻辑表示多个条件满足其中一个即可，在Q对象中可以通过|运算符组合多个Q对象实现OR查询，最终将组合后的Q对象传入filter方法即可。
单个OR条件查询
如果需要查询年龄大于18岁或者用户名为admin的用户，就可以用两个Q对象做OR组合：
# 查询年龄大于18岁 或者 用户名为admin的用户 result = User.objects.filter(Q(age__gt=18) | Q(username="admin"))
多个OR条件组合
OR逻辑也支持多个条件同时组合，比如查询年龄大于18岁、或者用户名为admin、或者邮箱包含test的用户：
# 三个OR条件组合查询
result = User.objects.filter(
Q(age__gt=18) | Q(username="admin") | Q(email__contains="test")
)
使用Q对象实现NOT逻辑查询
NOT逻辑表示排除某个条件，在Q对象中可以通过~运算符对单个Q对象取反，实现排除特定条件的查询效果。
单个NOT条件查询
如果需要查询用户名不是admin的所有用户，就可以对用户名条件的Q对象取反：
# 查询用户名不是admin的用户 result = User.objects.filter(~Q(username="admin"))
NOT与OR组合查询
NOT逻辑也可以和OR逻辑组合使用，比如查询年龄不大于18岁，或者用户名不是admin的用户：
# 查询年龄不大于18岁 或者 用户名不是admin的用户 result = User.objects.filter(~Q(age__gt=18) | ~Q(username="admin"))
Q对象与基础AND查询结合
Q对象可以和普通的filter关键字参数同时使用，此时普通参数代表AND逻辑，Q对象代表自定义逻辑，二者会共同作为查询条件。比如查询状态为正常的用户，并且满足年龄大于18岁或者用户名为admin：
# 状态为正常 AND (年龄大于18岁 或者 用户名为admin)
result = User.objects.filter(
status="normal",
Q(age__gt=18) | Q(username="admin")
)
注意事项
- Q对象的逻辑运算符优先级和普通Python逻辑运算一致，
~优先级高于&，&优先级高于|，如果需要调整优先级可以用括号包裹Q对象组合。 - Q对象的条件写法和普通filter的关键字参数完全一致，支持双下划线表示的各类查询表达式，比如
age__gte、email__icontains等。 - 如果查询条件中同时有多个Q对象组合，建议用括号明确逻辑分组，避免优先级问题导致查询结果不符合预期。
Q对象是Django ORM中处理复杂查询的高效工具，熟练掌握它的用法可以大幅减少手动拼接SQL的场景，让查询代码更简洁易维护。