sublime text本身不运行django，仅作为编辑器依赖本地python环境；需先验证django-admin可用性，再手动配置构建系统指定虚拟环境解释器路径和项目工作目录，并为模板文件手动切换django语法高亮。
Sublime Text 本身不运行 Django，它只是编辑器；真正起作用的是你本地 Python 环境里装的 django 和 django-admin。只要终端能跑 django-admin startproject，Sublime 就能配合开发——关键在环境对齐，不在编辑器功能多强。
确认 django-admin 是否可用，别跳过这步
很多人卡在这一步却以为是 Sublime 配置错了。打开终端，执行：
django-admin --version
如果有输出（比如 4.2.7），说明 Django 已安装且在 PATH 中；如果报 command not found 或 'django-admin' is not recognized，那就不是 Sublime 的问题，而是：
- 没装 Django：
pip install django - 装了但没进 PATH：检查是否用了虚拟环境，且没激活（
source venv/bin/activate或venv\Scripts\activate.bat） - PATH 没刷新：Windows 用户重启命令行，macOS/Linux 用户检查
.zshrc或.bash_profile是否导出正确路径
Sublime 的构建系统默认调用系统级 python 和 django-admin，不会自动读取你当前 shell 激活的虚拟环境。
配置 Build System 运行 manage.py，路径必须写死
Sublime 默认没有 Django 构建能力，得手动加一个 .sublime-build 文件。重点不是“怎么写”，而是“路径不能错”：
- 新建构建系统：
Tools → Build System → New Build System - 填入以下内容（注意替换
/path/to/your/project和解释器路径）：
{
"cmd": ["/path/to/your/venv/bin/python", "-u", "/path/to/your/project/manage.py", "runserver"],
"working_dir": "/path/to/your/project",
"file_regex": "^[ ]*File \"(*?)\", line ([0-9]*)",
"selector": "source.python"
}
常见坑：
-
cmd里写的 Python 路径必须是你项目实际用的解释器，比如虚拟环境里的venv/bin/python，不是系统/usr/bin/python3 -
working_dir必须设为项目根目录（含manage.py的那层），否则runserver找不到settings.py - 别指望 Sublime 自动识别
venv目录——它不读pyproject.toml或requirements.txt
Django 模板高亮要手动切换语法，不能靠文件后缀猜
装完 Djaneiro 或 HTML (Django Templates) 插件后，.html 文件依然灰成一片，是因为 Sublime 默认按原生 HTML 解析。必须显式指定语法：
- 打开一个模板文件（如
templates/base.html） - 点击窗口右下角当前语法名（通常是
HTML） - 从菜单中选
Django > HTML (Django)（Djaneiro）或HTML (Django Templates)
如果你硬要全局绑定所有 .html 文件：
{"extensions": ["html"], "syntax": "Packages/HTML/HTML (Django Templates).sublime-syntax"}
但代价是：前端组件、静态页、Markdown 导出的 HTML 全部失去 Emmet 补全和原生 HTML 标签提示。更稳妥的做法是只对 templates/ 下的文件生效——这需要 ApplySyntax 插件，但维护成本高，多数人用不到。
{% static %} 和 {% url %} 永远灰色，这不是 bug 是机制限制
即使语法插件装了、路径设对了、语法也手动切换了，{% static %}、{% url %}、{% load i18n %} 这些标签还是和 {% if %} 一样颜色。原因很实在：
- Sublime 的
.sublime-syntax基于静态正则匹配，无法解析{% load static %}动态引入的标签库 - 所有自定义模板标签都被当作普通 block 处理，作用域（scope）没区分
- 改语法文件硬加规则？升级插件时会被覆盖，还容易破坏括号匹配逻辑
接受这个事实比折腾高亮更省时间。真要验证这些标签是否写对，靠 python manage.py runserver 启起来看页面报错，或者用 SublimeLinter + django-html-linter 做静态检查，比颜色靠谱得多。
