Sublime Text 本身不运行 Django,仅作为编辑器;所有 manage.py 命令须在终端执行,配置核心是确保正确调用项目所需的 Python 解释器、工作目录和 Django 包,否则会报 ModuleNotFoundError 或 Command not found。

Sublime Text 本身不运行 Django,它只是编辑器;所有 python manage.py 命令都必须交由系统终端执行。所谓“配置环境”,本质是让 Sublime 能正确调用你项目所需的 Python 解释器、工作目录和 Django 包——漏掉任一环,就会报 ModuleNotFoundError: No module named 'django' 或 Command not found: django-admin。
为什么 Ctrl+B 运行 manage.py 总报错找不到 Django
根本原因:Sublime 启动时继承的 shell 环境没加载你的虚拟环境,或者没把 django-admin 所在路径加入 PATH。不是插件没装好,也不是 Sublime 有问题。
- Mac/Linux 用户尤其容易踩坑:双击图标启动 Sublime,它不会读取
~/.zshrc或~/.bash_profile,也就找不到你source venv/bin/activate后的环境 - Windows 用户常见问题是
cmd或powershell没激活虚拟环境,就直接点开 Sublime - 构建系统里写的
["python", "manage.py", "runserver"]默认调用的是系统 Python,不是你venv里的那个
解决办法只有一个:先在终端里激活虚拟环境,再从该终端启动 Sublime。例如:
source myenv/bin/activate subl .
这样 Sublime 才能继承当前 shell 的 PYTHONPATH 和 PATH,Ctrl+B 才会真正用上你装了 Django 的解释器。
立即学习“Python免费学习笔记(深入)”;
如何写一个靠谱的 Django 构建系统(Django.sublime-build)
不要改默认的 Python.sublime-build,新建一个专用于 Django 的构建系统,关键要锁定解释器路径和工作目录。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成,提供 184 种工具和 200 多条命令,用于安全分析和代码质量...
-
"cmd"必须用绝对路径指向虚拟环境里的python,比如["/Users/you/myproject/venv/bin/python", "${project_path}/manage.py", "runserver"] -
"working_dir"必须设为项目根目录,即含manage.py和settings.py的那层,推荐"${project_path}" -
"file_regex"保留默认正则即可,用于点击错误跳转到对应文件行号 - 如果想一键跑
migrate或shell,直接复制一份,只改"cmd"最后一个参数
保存为 Django.sublime-build 后,在项目中按 Tools → Build System → Django 切换,再按 Ctrl+B 就能启动服务。
怎么让 .html 文件自动识别为 Django 模板
Sublime 默认把 .html 当普通 HTML,{% if %} 和 {{ user.name }} 全部不着色。这不是 bug,是默认语法没覆盖 Django 扩展标签。
- 首选方案:安装官方维护的
HTML (Django Templates)语法包(通过 Package Control 搜索安装) - 安装后,打开任意
.html文件,点击右下角语法名称 → 选HTML (Django Templates) - 想永久生效?进
Preferences → Settings – Syntax Specific,填入:
{"extensions": ["html"], "syntax": "Packages/HTML/HTML (Django Templates).sublime-syntax"}
注意:{% load static %}、{% url %} 这类标签依然可能显示为灰色——语法高亮基于静态正则,无法解析动态加载的模板库,接受这点比折腾插件更实际。
SideBarEnhancements 右键菜单为啥不显示 manage.py 相关命令
SideBarEnhancements 默认不识别 manage.py 是 Django 入口,它只提供通用终端打开功能。想右键直接跑命令,得手动配置。
- 右键
manage.py→Open Terminal Here(macOS/Linux)或Open Command Prompt Here(Windows) - 然后手动输
python manage.py runserver,别指望它自动补全子命令 - 如果非要右键一键运行,得配合 Terminus 插件 + 自定义命令,但稳定性差、调试困难,不如老实用终端
真正省事的方式是:用 Ctrl+Shift+P 呼出命令面板,输入 Terminal: New Terminal(Terminus),它会自动 cd 到当前文件所在目录,再敲命令——比依赖右键菜单更可控。
最常被忽略的一点:Sublime 的项目配置(.sublime-project)里可以绑定专属构建系统、设置 python_interpreter 路径、甚至指定不同环境的 env 变量。单靠全局设置或临时改构建系统,多人协作或切换项目时极易出错。

















