本文介绍如何在 Django 中使用 Case 和 When 表达式，基于指定的类别 ID 列表对 QuerySet 进行精确、可控的优先级排序。
本文介绍如何在 django 中使用 `case` 和 `when` 表达式，基于指定的类别 id 列表对 queryset 进行精确、可控的优先级排序。
在实际开发中，我们常需要打破数据库默认的自然排序（如主键或时间），按业务定义的特定顺序展示数据。例如，给定一个类别 ID 列表 [3, 5, 1, 4, 2]，希望所有属于 category_id=3 的产品排最前，其次为 category_id=5 的产品，依此类推——这种“非字典序、非数值序”的显式优先级排序，无法通过简单的 order_by('category_id') 实现，而需借助 Django 的条件表达式。
Django 提供了强大的 Case + When 组合，可在数据库层面动态计算排序字段。核心思路是：为每个目标 category_id 分配一个整数优先级（索引位置），然后按该优先级字段排序：
from django.db.models import Case, Value, When
category_ids = [3, 5, 1, 4, 2]
products = Product.objects.filter(
category_id__in=category_ids
).alias(
priority=Case(
*[When(category_id=cat_id, then=Value(idx)) for idx, cat_id in enumerate(category_ids)]
)
).order_by('priority')✅ 说明：
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
-
filter(category_id__in=category_ids)确保只查询目标类别的产品，提升性能与准确性； -
alias()在查询中创建一个临时字段priority，其值由Case动态决定（如category_id=3 → priority=0，category_id=5 → priority=1）； -
order_by('priority')按此虚拟字段升序排列，实现完全可控的顺序。
⚠️ 注意事项：
- 此方案在数据库层执行，无需 Python 层二次排序，高效且可链式调用（如后续
.select_related()或分页）； - 当
category_ids列表过长（如 >100 项）时，生成的 SQLCASE WHEN子句会变大，可能影响查询计划效率。此时建议改用数据库原生支持的排序函数（如 PostgreSQL 的array_position），或预存priority字段到模型中； - 若某产品所属 category 不在
category_ids中，将被filter排除；如需保留并置后，可移除filter并将Case中未匹配项设为高优先级（如default=Value(999)）。
总之，Case + When 是 Django 实现灵活、声明式优先级排序的标准且推荐方式，兼顾可读性、可维护性与数据库性能。
