list_display支持外键字段需用双下划线如'author__name'，自定义方法须定义在ModelAdmin中并设short_description；排序需显式指定admin_order_field。
怎么让 list_display 显示外键字段和自定义方法
默认 list_display 只接受字段名字符串，直接写 author.name 会报错：FieldError: Cannot resolve keyword 'author.name' into field。必须把外键字段“扁平化”成 admin 可识别的表达式。
实操建议：
- 外键字段用双下划线：写成
'author__name'，Django 会自动 JOIN 查询（但注意 N+1 问题） - 自定义方法需在 ModelAdmin 类里定义，返回值会被显示，且可加
short_description属性控制表头文字 - 方法里别直接访问
self——它指向 ModelAdmin 实例，不是 model 实例；参数是当前 model 对象，比如def get_full_title(self, obj): return f"{obj.title} ({obj.category})" - 如果方法涉及数据库查询（如
obj.tags.all().count()），务必用select_related或prefetch_related在get_queryset里预加载，否则列表页性能暴跌
search_fields 怎么支持模糊匹配、跨表和中文分词
search_fields 默认只做 icontains（大小写不敏感的包含匹配），但不支持全文检索，也不自动处理中文分词——搜“用户管理”可能查不到含“用户”和“管理”的两条独立记录。
实操建议：
- 跨外键字段同样用双下划线：
'author__username'、'category__slug' - 字段前加
^表示“开头匹配”（istartswith），加$表示“精确匹配”（iexact），避免全表扫描 - 中文搜索弱？别依赖
search_fields做主力——它底层是 SQLLIKE，对中文效果差；真要好体验，得接django-haystack或pg_search（PostgreSQL 的to_tsvector） - 字段太多会拖慢查询，尤其带
__的跨表字段；上线前用 Django Debug Toolbar 看实际生成的 SQL，确认没意外 JOIN
为什么加了 list_display 里的方法却点不了排序
默认所有 list_display 项都不可排序，包括模型字段——除非显式声明 admin_order_field。自定义方法更不会自动关联数据库字段，点了标题栏排序就报错：Cannot resolve keyword 'get_status' into field。
实操建议：
- 给方法加
admin_order_field属性，指向真实字段或表达式，比如get_status.admin_order_field = 'status' - 如果排序逻辑复杂（如按状态优先级数字排序），可以设为
admin_order_field = 'status_priority'，再在get_queryset里用.annotate(status_priority=Case(...))注入计算字段 - 别在
admin_order_field里写不存在的字段，Django 不校验，出错时只报晦涩的FieldError - 外键字段排序（如
'author__date_joined'）没问题，但要注意：如果 author 为空，该行在排序后可能被排到最前或最后，行为取决于数据库 NULLS FIRST/LAST 设置
search_fields 搜不到 null 字段或空字符串怎么办
search_fields 对 NULL 和空字符串 '' 默认不匹配——比如 phone 字段允许为空，搜 "" 或 "null" 都没结果。
实操建议：
- Django admin 没内置搜 NULL 的语法，得自己重写
get_search_results - 简单方案：在
search_fields加一个固定值字段（如'id'），然后在get_search_results里拦截关键词，手动追加Q(phone__isnull=True)这类条件 - 空字符串同理，加
Q(phone='') | Q(phone__isnull=True)，但注意别和用户正常搜索冲突——比如用户真想搜字符串"null"，就得加判断逻辑区分意图 - 这个方法绕过了 admin 默认搜索流程，调试时记得检查
qs是否被多次 filter，避免漏数据或重复过滤
真正麻烦的不是怎么写，而是改完之后忘了清缓存、没测边界 case（比如空搜索、超长关键词、特殊符号），结果线上 admin 搜索突然失效，还查不出原因。
