Django Admin 本身不“高定制化”，但通过继承 admin.ModelAdmin 并组合使用关键属性，能在零前端代码前提下实现远超预期的定制效果——前提是别试图用它替代 Vue/React 管理复杂交互。
直接说结论：Django Admin 本身不“高定制化”，但通过继承 admin.ModelAdmin 并组合使用关键属性，能在零前端代码前提下实现远超预期的定制效果——前提是别试图用它替代 Vue/React 管理复杂交互。
为什么 list_display 不能直接写字段名以外的东西
你写 list_display = ['title', 'price'] 没问题，但一旦加了自定义方法（比如带 HTML 的状态标签），就容易报 AttributeError: 'str' object has no attribute 'short_description'。这是因为 Django 要求所有非字段名的可调用对象必须显式声明 short_description。
- 模型里定义的方法（如
def status_badge(self): ...）必须加status_badge.short_description = "状态" - 如果返回的是 HTML（比如用
format_html），还要在方法上加@admin.display(description="状态")或手动设short_description，否则会转义成纯文本 -
list_display中不能放 lambda、闭包或未绑定的函数，只接受字符串（字段名）、方法名（绑定到实例）、或带@admin.display装饰器的函数
search_fields 和 list_filter 的字段类型陷阱
看似简单，但填错字段名会导致后台搜索/筛选完全失效，且无任何报错提示。
-
search_fields只支持CharField、TextField等文本型字段；对ForeignKey必须用双下划线语法，比如search_fields = ['author__name', 'category__title']，直接写'author'会静默忽略 -
list_filter对DateField/DateTimeField自动启用日期筛选小部件，但对BooleanField需要显式写成list_filter = ['is_active', 'is_staff']，不能省略 - 若字段是
choices类型（如status = models.CharField(choices=STATUS_CHOICES)），Django 会自动识别并生成下拉筛选，无需额外配置
fieldsets 和 fields 别混用，否则表单崩溃
两者功能重叠但互斥：fields 是扁平字段列表，fieldsets 是分组结构。同时定义会触发 ImproperlyConfigured 异常。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
立即学习“Python免费学习笔记（深入）”；
- 用
fields快速控制单行显示顺序，支持元组分组：fields = ('title', ('price', 'market_price'), 'info') - 用
fieldsets做视觉分层和折叠：fieldsets = [('基础信息', {'fields': ('title', 'pub')}), ('价格', {'classes': ('collapse',), 'fields': ('price', 'market_price')})] -
exclude是兜底方案，仅当不想改fields或fieldsets时临时隐藏字段；但它不阻止字段被提交（除非配合readonly_fields）
actions 批量操作为什么总不生效
注册了 action 函数，但在后台列表页看不到下拉菜单？大概率是没打开开关，或权限没配对。
- 必须显式设置
actions_on_top = True（默认是True，但某些旧版本模板可能覆盖） - 自定义 action 函数第一个参数必须是
modeladmin，第二个是request，第三个是queryset；漏掉任一参数会静默失败 - 如果模型有自定义
Manager，确保 action 中的queryset仍能访问到全部数据（比如 manager 过滤了is_active=True，那批量操作就只能作用于活跃项） - action 返回值必须是字符串（用于消息提示），否则后台会报 500 且无日志 —— 最好加上
return f"成功处理 {queryset.count()} 条记录"
真正难的不是写多少配置，而是判断哪些逻辑该放 Admin、哪些该抽成独立视图。比如导出 Excel、审核流跳转、富文本编辑——这些强行塞进 Admin 会迅速失控。留个心眼：Admin 是数据看板，不是业务中台。
