Sublime Text 不能内置运行 Django,它只是编辑器;所有运行、调试、跳转均依赖外部 Python 环境、正确构建系统及语法识别配置,关键在于构建系统中 cmd 必须用绝对路径指向项目虚拟环境的 Python 解释器,并配合 .sublime-project 文件启用上下文。

Sublime Text 不能“内置运行” Django,它只是编辑器;所有运行、调试、跳转都依赖外部 Python 环境 + 正确的构建系统 + 语法识别配置。装一堆插件却没配对解释器路径,是绝大多数人卡住的根源。
怎么让 manage.py 在 Sublime 里真正跑起来
关键不是“能不能 Ctrl+B”,而是命令是否调用了你项目真正的 Python 解释器(尤其是虚拟环境里的)。
-
cmd字段必须用绝对路径指向你的虚拟环境 Python,比如["/Users/me/myproject/venv/bin/python", "manage.py", "runserver"](macOS/Linux)或["C:\myproject\venv\Scripts\python.exe", "manage.py", "runserver"](Windows) - 别写
["python", ...]——它默认调系统 Python,大概率没装 Django 或版本不匹配 -
working_dir设为"${project_path}",确保manage.py能正确读取settings.py和INSTALLED_APPS - 保存为
Django.sublime-build,放在Packages/User/目录下,之后在项目根目录按Ctrl+B才生效
为什么 {{ variable }} 和 {% block %} 不高亮、不补全
不是插件没装,是 Sublime 根本没把文件当 Django 模板处理——Djaneiro 提供了语法定义,但不会自动绑定文件类型。
- 打开一个
templates/base.html,点击右下角 “HTML”,选Django > HTML (Django) - 这个设置只对当前文件有效;想让所有
templates/下的.html自动识别,需在项目.sublime-project文件中加syntaxes规则 - 别全局把所有
.html绑定到 Django 语法,否则静态页、Markdown 导出 HTML 会乱码高亮 - 如果高亮颜色太淡,检查主题是否支持
variable.template.embedded.django这个作用域,部分主题会忽略它
怎么从 User.objects.all() 快速跳到 User 模型定义
Sublime 原生不索引 Django 的跨文件模型关系,Ctrl+Click 无效是正常现象,得换策略。
立即学习“Python免费学习笔记(深入)”;
- 确保当前文件是
models.py,按Ctrl+R(macOSCmd+R),输入classs+(w+)s*:可快速列出所有 Model 名 - 在
views.py中把光标停在User上,按Ctrl+Shift+R(Goto Anything),输入User,Sublime 会搜索整个项目含该字符串的行——虽然不精准,但比翻文件快得多 - 别指望 Anaconda 或 Jedi 自动解析
from django.contrib.auth.models import User的导入链;它们只做基础符号解析,不理解 Django 的动态注册机制
最常被忽略的点:所有配置(构建系统、语法绑定、项目设置)都以项目为单位生效。不建 .sublime-project 文件,就等于没真正启动 Django 开发上下文——临时改的语法、随便选的构建系统,下次关掉再打开就回退了。


















