最快方法是在modeladmin类中直接设置fields属性，按需列出字段名列表，该方式零配置、立即生效、兼容性强；次选方案是使用fieldsets分组并嵌套元组实现横向排布，注意fields与fieldsets互斥。
如何用 ModelAdmin 控制字段显示顺序和分组
默认 Admin 界面把所有字段堆成一列，实际管理时根本没法高效操作。关键不是“能不能改”，而是改哪儿、怎么改才不破坏 Django 的字段依赖逻辑。
ModelAdmin 提供了 fields 和 fieldsets 两个核心配置项，它们互斥：用了 fieldsets 就别设 fields，否则报错 ImproperlyConfigured。
-
fields = ('title', 'slug', 'pub_date')：纯线性排列，适合简单模型；注意外键字段（如author）会自动渲染下拉选择，但没做缓存，大数据量时卡顿 -
fieldsets = [('基础信息', {'fields': ('title', 'slug')}), ('发布设置', {'fields': ('pub_date', 'is_published')})]：支持折叠、分组、标题，fields内部还能嵌套元组实现横向排布，比如('title', 'slug')会让这两个字段并排显示（需浏览器支持 CSS Grid） - 别把
id或created_at这类只读字段写进fields，否则保存时报KeyError；要用readonly_fields单独声明
为什么 list_display 里不能直接写方法名以外的字段
你在 list_display 里填 'status' 没问题，但填 'get_status_display' 就得额外加一层封装——因为 Admin 不会自动识别 Model 方法的返回值类型，它只信任明确标注了 short_description 的函数。
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 错误写法：
def get_status_display(self): return self.get_status_display()—— 这会导致递归调用，页面直接 500 - 正确写法：
def status_label(self, obj): return obj.get_status_display(); status_label.short_description = '状态'，然后在list_display中写'status_label' -
list_display支持元组字段（如('author__name',)），但不支持双下划线链式调用带括号的方法，比如'author__get_full_name()'会报AttributeError
search_fields 和 list_filter 的性能陷阱
加了搜索框和筛选栏很爽，但数据库没建索引的话，一个 search_fields = ('title', 'content') 就能让百万级表查询变秒开。
-
search_fields默认走icontains，对 MySQL 是全表扫描；PostgreSQL 虽支持pg_trgm扩展，但要手动CREATE EXTENSION pg_trgm并加 GIN 索引 -
list_filter对ForeignKey字段会自动生成下拉筛选，但如果关联表有 10w+ 记录，Admin 加载时就会查出全部，卡死；此时必须配合raw_id_fields = ('author',)，改成输入 ID 查找 -
list_filter支持自定义类，比如按日期范围过滤，但别在lookups()方法里做复杂查询，它会在每次 Admin 页面渲染时执行
覆盖默认模板时最容易漏掉的继承点
想改按钮位置或加 JS 行为？直接复制 admin/change_form.html 到项目模板目录是常见做法，但多数人忘了重写 change_view 方法里的 extra_context 传参逻辑。
- Django Admin 模板依赖
{{ opts }}{{ adminform }}这些上下文变量，删掉或拼错会导致表单字段消失，而不是样式错乱 - 如果用了
inlines，还要确保子表单模板路径正确，Django 默认找admin/<app>/<model>/change_form.html</model></app>，不是根目录下的通用模板 - 静态资源别硬编码路径，用
{% static 'js/custom-admin.js' %}，否则 DEBUG=False 时 collectstatic 后找不到文件
get_queryset() 方法的权限过滤——它不光影响列表数据，还决定 fieldsets 里外键下拉选项的范围。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
