Sublime Text中快速编写Django admin模板应继承admin/base_site.html，而非重写完整HTML结构；需将自定义模板置于templates/admin/下匹配路径，并正确配置TEMPLATES['DIRS']指向该目录，同时注意SimpleUI等第三方主题的覆盖优先级。
Sublime Text 里怎么快速写出 Django admin 模板？
直接用 {% extends "admin/base_site.html" %} 开头，别自己重写整个 HTML 结构。Django 的 admin 模板继承链很明确：所有自定义 admin 模板都该基于 admin/base_site.html，它已经加载了 jQuery、admin CSS、全局导航和侧边栏。自己从 写起，反而容易漏掉 CSRF token、i18n 支持或 JS 初始化逻辑。
常见错误是复制粘贴 admin 源码里的某个页面（比如 change_form.html）然后删删改改——结果发现按钮没响应、字段不渲染、保存后跳转错乱。根本原因：Django admin 模板依赖大量上下文变量（如 opts、adminform、errors），这些不是静态 HTML 能模拟出来的。
- 正确做法：在项目
templates/admin/下新建文件，路径必须匹配 Django 查找规则，例如想覆盖用户编辑页，就建templates/admin/auth/user/change_form.html - 用
{% block content %}{% endblock %}替换局部内容，其他区块（extrahead、object-tools）按需覆写 - Sublime Text 可装插件
Djaneiro或Emmet，输入loadstatic+ Tab 就能补全{% load static %}，输入url+ Tab 补全{% url 'admin:xxx' %}
Django-builtins 在 admin 模板里到底能用哪些标签？
django-builtins 不是一个独立包，它是 Django 内置模板标签的统称——即 admin 模板引擎默认启用的那些，比如 {% url %}、{% static %}、{% trans %}、{% get_current_language %}。你不需要额外 {% load %} 它们，但要注意：不是所有内置标签都能在 admin 模板里安全用。
最容易踩坑的是 {% include %} 和 {% ssi %}：{% include %} 可以用，但被 include 的模板若依赖父模板上下文（比如 original 对象），必须确保传入；{% ssi %} 在 admin 模板中默认禁用，强行启用会报 TemplateSyntaxError: 'ssi' is not a registered tag library。
- 安全可用：
{% url %}（推荐用命名空间形式，如{% url 'admin:auth_user_changelist' %}）、{% static %}（路径前不加/static/，Django 自动拼接）、{% trans %}（中文环境必须开启USE_I18N = True） - 慎用：
{% now %}—— admin 页面常被缓存，时间戳可能不刷新；{% cycle %}—— 在列表页（change_list.html）里用容易错位 - 绝对不用：
{% regroup %}（admin 列表已由list_display控制分组逻辑）、{% lorem %}（调试时可临时用，上线必须删）
为什么 Sublime Text 里写完模板却没生效？
最常见原因是 Django 找不到你的模板路径。它不会自动扫描项目根目录下的 templates/，必须显式告诉它：settings.py 里 TEMPLATES 配置的 'DIRS' 列表要包含绝对路径，且该路径下必须有 admin/ 子目录结构。
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
例如，你把模板放在 myproject/templates/admin/auth/user/change_form.html，那 settings.py 必须写成：
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [BASE_DIR / 'templates'], # 注意：不是字符串 'templates'，而是 pathlib.Path 或 os.path.join
'APP_DIRS': True,
...
}
]另一个隐形陷阱：Django 默认开启 DEBUG = True 时会重新扫描模板，但一旦设为 False，它只在启动时加载一次模板缓存。改完模板后如果 DEBUG=False，必须重启服务器才能生效。
- 验证路径是否生效：在视图里临时加一行
print(get_template('admin/auth/user/change_form.html'))，看是否抛出TemplateDoesNotExist - 检查文件权限：Linux/macOS 下，Sublime Text 保存的文件如果是
600权限，Django 进程可能读不到 - 别用 Windows 风格路径分隔符：
templates\admin\...在 settings 里会失效，一律用正斜杠或pathlib.Path
SimpleUI 会不会干扰你写的 admin 模板？
会，而且干扰方式很隐蔽。SimpleUI 本质是通过替换 Django admin 的基础模板（base_site.html、change_form.html 等）来实现美化，它把自己的模板放在 simpleui/templates/admin/ 目录下，并靠 INSTALLED_APPS 顺序决定覆盖优先级：越靠前的 app，它的模板越优先被加载。
如果你把 'simpleui' 放在 INSTALLED_APPS 最前面，那即使你在项目 templates/admin/ 下写了同名模板，Django 也会优先用 SimpleUI 的——除非你把项目模板路径加到 TEMPLATES['DIRS'] 且确保它排在 APP_DIRS=True 之前。
- 调试方法：在浏览器里打开 admin 页面，右键「查看网页源代码」，搜索
<title></title>或某个明显 class，看它来自哪个文件路径 - 稳妥做法：不覆盖 SimpleUI 已修改的模板（如
base_site.html），只覆写它没动的局部模板（如auth/user/change_form.html） - 真要深度定制，建议 fork SimpleUI 仓库，改完再 pip install -e ./your-forked-simpleui，而不是硬碰硬覆盖
实际开发中，真正卡住人的往往不是语法，而是 Django 模板查找机制与 admin 渲染上下文的耦合程度——它不像普通前端框架那样“所见即所得”。改一行 HTML 前，先确认这行属于哪个 block、依赖哪些 context 变量、是否被第三方主题拦截，比盲目补全标签重要得多。
