Django Admin开箱即用，注册模型即可获得搜索、过滤、分页等功能；需配置list_display等属性提升体验，注意权限控制、静态文件部署及Django 5.0兼容性要求。
直接用 django.contrib.admin 就够了，别自己重写 CRUD
Django 5.0 的 admin 系统不是“需要配置才能用”的半成品，而是开箱即用的后台管理核心。只要你定义好 Model，注册进 admin.site.register()，就能立刻获得带搜索、过滤、分页、批量操作的完整后台界面。
常见错误是试图绕过 admin 自己写视图——结果重复实现权限校验、表单渲染、数据验证，还漏掉 CSRF 防护或对象级权限控制。Django admin 已内置 is_staff 检查、has_change_permission() 钩子、list_filter 字段自动转成筛选器，这些轮子不白给。
- 注册模型时别只写
admin.site.register(MyModel)，至少加个list_display控制首页列，否则只能看到MyModel object (1) - 外键字段想显示关联对象名称？确保关联模型有
__str__方法返回有意义的字符串 - 如果模型字段含
DateTimeField，加date_hierarchy = 'created_at'，顶部立刻多出时间导航栏
ModelAdmin 里改什么最影响实际体验
真正决定后台好不好用的，不是功能多寡，而是字段是否可读、操作是否顺手、加载是否卡顿。重点调这几个属性：
-
search_fields = ['name', 'email']：触发全文搜索（底层用 SQLLIKE），别写__icontains——那是查询用的，admin 不认 -
list_filter = ['status', 'is_active', 'created_at']：日期字段会自动拆成年/月/日筛选，布尔字段变成“是/否”开关 -
readonly_fields = ['created_at', 'updated_at']：防止编辑时间戳；若字段在fields或fieldsets中未声明，readonly 无效 -
autocomplete_fields = ['author', 'category']：替代下拉框，适合外键选项超 50 条的场景（需对应 Model 实现get_search_results()）
性能陷阱：list_select_related = ['author'] 能避免 N+1 查询，但只对 ForeignKey 有效；list_prefetch_related 用于 ManyToMany，别混用。
立即学习“Python免费学习笔记（深入）”；
用户权限和菜单分组怎么不写死又不裸奔
admin 后台默认把所有模型堆在“认证和授权”“站点”等默认分组里，但业务模型一多就乱。靠 AppConfig.verbose_name 只能改应用名，真要分组得动 AdminSite。
- 在
admin.py顶部实例化自定义 site：my_admin_site = admin.AdminSite(name='myadmin') - 注册模型时用
my_admin_site.register(MyModel, MyModelAdmin)，再在 URLconf 里指向它 - 权限控制别只依赖
is_superuser：给普通 staff 用户分配add_post、change_post等具体权限，比开放整个 app 更安全 - 隐藏某个模型？在
ModelAdmin里重写has_module_permission(self, request)返回False
注意：Django 5.0 默认关闭 admin 的模板缓存，开发时改 admin/change_list.html 要重启服务才生效，别以为模板没生效是代码错了。
部署前必须检查的三个硬性限制
Django admin 不是玩具，上线前这几个点卡住就真不能用：
-
DEBUG = False时，ALLOWED_HOSTS必须包含域名或 IP，否则 admin 静态文件 404（CSS/JS 加载失败，页面只剩纯文本） - PostgreSQL 用户没给
pg_trgm扩展？search_fields用__trigram_similar会报undefined function错误 - 若用 Nginx 反向代理，确保传了
X-Forwarded-Proto头，否则 admin 登录后跳http://而非https://，触发混合内容拦截
最常被忽略的是静态文件路径：Django 5.0 要求 python manage.py collectstatic 后，Web 服务器必须能从 /static/admin/ 下访问到文件，而不是靠 Django 自己 serve——本地开发不显，一上生产立刻白屏。
