Q对象组合必须显式加括号控制优先级，NOT需注意NULL处理，Q不能直接引用annotate字段或子查询外的聚合结果。
Q() 里怎么写 OR 条件，不是用 | 就完事了
直接用 | 没问题，但容易漏掉括号导致优先级错乱。Django 的 Q 对象不自动加括号，Q(status='draft') | Q(status='pending') & Q(created_at__year=2024) 实际等价于 Q(status='draft') | (Q(status='pending') & Q(created_at__year=2024))——这通常不是你想要的。
- 所有多条件组合必须显式用
Q(...)包裹再运算，比如想查 “是 draft 或 pending，且都发生在 2024 年”，得写成(Q(status='draft') | Q(status='pending')) & Q(created_at__year=2024) - 避免链式调用写成
Q(...) | Q(...) | Q(...)后续再&，它会从左到右算，没括号就容易出错 - 复杂逻辑建议拆成变量，比如
is_draft_or_pending = Q(status='draft') | Q(status='pending')，再跟其他条件组合，可读性和调试都更稳
NOT 查询别只记得 ~，得防空值和索引失效
~Q(field__isnull=False) 看似是否定，但实际生成 SQL 是 NOT (field IS NOT NULL)，等价于 field IS NULL；而 ~Q(field='abc') 会生成 field != 'abc'，但注意：它**不会包含 NULL 行**（SQL 中 NULL != 'abc' 结果是 UNKNOWN，被过滤掉）。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
- 要真正查 “field 不等于 'abc' 或为 NULL”，得手动补上：
~Q(field='abc') | Q(field__isnull=True) -
~Q在字段无索引或使用函数（如__icontains）时，可能让数据库放弃走索引，查大表前先explain看执行计划 - 别在
exclude()里嵌套~Q(~Q(...))，Django 不会自动简化，反而增加解析开销
多个 Q 对象拼接时，reduce() 和 functools.reduce() 用法差异
动态构造一堆 OR 条件（比如用户勾选多个标签），有人直接用 functools.reduce(operator.or_, q_list)，但这在空列表时会报错；Django 自带的 Q 类其实支持初始化为 Q()（空条件，等价于 True），更适合安全拼接。
- 安全写法：
from functools import reduce; from operator import or_; q = reduce(or_, q_list, Q())—— 第三个参数Q()是兜底，空列表时返回恒真条件 - 别用
Q(*q_list, _connector=Q.OR)，这个语法不存在，Q不接受_connector参数 - 如果最终要传给
filter()，确保拼完后不是空Q()，否则可能意外查出全表（尤其配合exclude()时更危险）
Q() 嵌套 annotate 或 subquery 容易触发 Cannot resolve keyword
Q 本身不能直接引用 annotate 出来的字段名，比如你 .annotate(total=Sum('items__price')) 之后，在 filter(Q(total__gt=100)) 会报错，因为 Q 解析阶段还没走到 annotation。
- 这种场景必须换用
filter()的字典解包或Case/When，例如：.filter(total__gt=100)（直接用字段名，不用Q） - 真要用
Q组合带聚合的逻辑，得把整个聚合逻辑塞进Q的__exact或类似表达式里，但非常受限，多数时候不如改用having或原生 SQL - 子查询同理：
Q(id__in=Subquery(...))可以，但Q(some_annotated_field__in=...)不行，annotation 必须在子查询内部完成
Q 的运算优先级、NULL 处理的 SQL 语义、以及它和 annotation/subquery 的生命周期错位。 
