Q对象拼接|实现“或”逻辑时易错点在于嵌套优先级、空值过滤及与filter()混用导致的隐式AND行为；正确做法是将所有条件统一用Q封装后组合。
直接用 Q 对象拼接 | 就能实现“或”逻辑，但真正容易出错的是嵌套优先级、空条件过滤、以及与 filter() 混用时的隐式 & 行为。
为什么 Q(name__icontains='a') | Q(email__icontains='a') 有时查不到数据？
常见原因是混用了普通关键字参数和 Q 对象。Django 会把两者合并成 AND 关系，相当于：WHERE (name LIKE '%a%' OR email LIKE '%a%') AND is_active=True（如果写了 is_active=True）。
- 错误写法：
User.objects.filter(Q(name__icontains='a') | Q(email__icontains='a'), is_active=True) - 正确写法：把所有条件都包进
Q，再用|或&连接：Q(name__icontains='a') | Q(email__icontains='a') | Q(profile__bio__icontains='a') - 或者用
filter()套一层：User.objects.filter((Q(name__icontains='a') | Q(email__icontains='a')) & Q(is_active=True))
多个字段模糊匹配“或”，但想排除空值或 None
__icontains 在字段为 None 或空字符串时不会匹配，但如果你的字段允许为空且数据库里存了 NULL，__icontains 本身不触发异常，只是不匹配——这容易让人误以为逻辑没生效。
- 显式排除空值：
Q(name__isnull=False) & Q(name__icontains='a') - 同时处理空字符串：
Q(name__isnull=False) & ~Q(name='') & Q(name__icontains='a') - 更简洁的写法（Django 4.2+）：
Q(name__regex=r'.+a.+')，但注意正则性能开销更大
动态构建“或”条件列表，避免手动写一堆 |
硬编码 q = Q(x=1) | Q(y=2) | Q(z=3) 不可维护。应该用 functools.reduce 或循环累积。
立即学习“Python免费学习笔记（深入）”；
from functools import reduce
from django.db.models import Q
conditions = [
Q(name__icontains='alice'),
Q(email__endswith='@gmail.com'),
Q(profile__tags__contains=['python']),
]
q_obj = reduce(lambda x, y: x | y, conditions)
users = User.objects.filter(q_obj)
- 如果
conditions为空列表，reduce会报错，需提前判断：if not conditions: return User.objects.none() - 不能用
or替代|—— Python 的or返回对象本身，不是合并后的Q - 注意
Q对象不可变，每次|都生成新实例，别试图复用同一Q多次修改
最常被忽略的是：当用 Q 组合多个 __in 或嵌套关系查询（如 profile__tags__in）时，数据库可能生成笛卡尔积或慢查询，务必用 .explain() 看执行计划，必要时拆成多次查询或加数据库索引。
