case/when排序不能直接写在order_by里，因为它是数据库层面的条件表达式，必须通过annotate()先生成临时字段再排序；直接使用会报fielderror。
Case/When排序为什么不能直接写在order_by里？
因为 Case 和 When 是数据库层面的条件表达式，必须配合 annotate() 先生成一个临时字段，再对这个字段排序。直接丢进 order_by() 会报 FieldError: Cannot resolve keyword 'Case' into field。
典型错误写法：MyModel.objects.order_by(Case(...)) —— 这根本过不了 Django ORM 的解析层。
正确路径是：用 annotate() 注入计算字段 → 再用该字段名排序。
如何用Case/When实现多级优先级排序（比如“已发布 > 审核中 > 草稿”）？
关键在于把业务状态映射成可比较的数值，再按这个数值排序。注意 Case 必须配 output_field 显式声明类型，否则 PostgreSQL 可能推导失败，MySQL 有时会静默转成字符串导致排序错乱。
from django.db.models import Case, When, IntegerField, Q
<p>queryset = MyModel.objects.annotate(
status_priority=Case(
When(status='published', then=1),
When(status='reviewing', then=2),
When(status='draft', then=3),
output_field=IntegerField()
)
).order_by('status_priority')</p>
- 每个
When的then=值必须是同类型（推荐整数），避免混用字符串和数字 - 没匹配到的记录默认为
None，会排在最前（ASC）或最后（DESC），如需统一兜底，加default=99 - 多个
When条件有重叠时，Django 按书写顺序取第一个匹配项，顺序很重要
Case/When结合F表达式做动态数值排序（比如“置顶权重 + 创建时间”）？
常见需求：置顶文章排最前，其余按发布时间倒序。这里不能只靠 Case 返回固定值，得组合 F() 引用字段。
from django.db.models import Case, When, F, Value
<p>queryset = Article.objects.annotate(
sort_key=Case(
When(is_pinned=True, then=Value(0)),
default=F('created_at'),
output_field=DateTimeField() # 注意：Value(0) 是 int，F('created_at') 是 datetime，类型必须一致！
)
).order_by('sort_key')</p>
上面代码会报错——Value(0) 和 F('created_at') 类型冲突。正确做法是把时间转成可比数值，或拆成两层排序：
- 方案一（推荐）：用两个字段排序：
.order_by('-is_pinned', '-created_at')，简单且高效 - 方案二：统一转为时间戳整数：
When(is_pinned=True, then=Value(9999999999))，其余用F('created_at__timestamp')（需数据库支持） - 方案三：用
Coalesce+Cast强制类型转换，但跨数据库兼容性差，仅限 PostgreSQL
PostgreSQL vs MySQL 在Case/When排序中的实际差异
MySQL 8.0+ 对 Case 支持较好，但旧版（5.7）不支持在 ORDER BY 中直接引用 annotate 字段；PostgreSQL 更严格，要求 output_field 必须明确，且 When 中的 then 值不能是混合类型表达式（比如 then=F('a')+F('b') 在某些版本会失败）。
一个容易被忽略的点：如果排序字段涉及 NULL，MySQL 默认把 NULL 排最前，PostgreSQL 默认排最后。用 NullsLast 或 NullsFirst 显式控制（Django 4.2+ 支持）：
.order_by(F('status_priority').desc(nulls_last=True))
低版本 Django 需靠数据库原生 SQL 或两次查询绕过。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
