需先安装Django并验证django-admin可用性,再配置Sublime的构建系统运行manage.py,结合SideBarEnhancements执行命令,用logging或django-debug-toolbar调试,注意手动刷新页面。

安装 Django 并验证 django-admin 是否可用
Sublime Text 本身不运行 Django,它只是编辑器;真正运行靠的是系统已安装的 Python 环境。先确认终端里能调用 django-admin:
- 在命令行执行
which django-admin(macOS/Linux)或where django-admin(Windows),有输出说明已安装 - 若报错
command not found或'django-admin' is not recognized,说明没装 Django 或未加入 PATH - 推荐用虚拟环境:先
python -m venv myenv,再source myenv/bin/activate(Linux/macOS)或myenv\Scripts\activate(Windows),最后pip install django
注意:Sublime 的构建系统默认调用系统 Python,不会自动识别虚拟环境。如果项目依赖虚拟环境里的包,后续需手动指定解释器路径。
配置 Sublime 的 Python 构建系统运行 manage.py
让 Sublime 能直接运行 python manage.py runserver,需要自定义构建系统:
- 菜单栏选择 Tools → Build System → New Build System
- 替换默认内容为以下 JSON(注意修改
"file_regex"和"cmd"中的路径)
{
"cmd": ["python", "${project_path}/manage.py", "runserver"],
"file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "${project_path}",
"selector": "source.python",
"shell": true
}
保存为 Django.sublime-build。之后打开项目根目录(含 manage.py),按 Ctrl+B(Windows/Linux)或 Cmd+B(macOS)即可启动开发服务器。
立即学习“Python免费学习笔记(深入)”;
常见问题:ImportError: No module named django 多因 Python 解释器路径不对——把 "cmd" 改成绝对路径,例如 ["/path/to/myenv/bin/python", ...]。
用 Sublime 的 SideBarEnhancements 快速执行常用 Django 命令
纯靠构建系统只能跑固定命令,而 manage.py 有很多子命令(makemigrations、shell、createsuperuser)。装 SideBarEnhancements 插件后,右键文件夹或 manage.py 就能触发:
- 安装插件:通过 Package Control 搜索并安装
SideBarEnhancements - 右键点击项目根目录 → Open Terminal Here(会打开系统终端,不是 Sublime 内置)
- 或者右键
manage.py→ Open Command Prompt Here(Windows)或 Open Terminal Here(macOS/Linux),然后手动输命令
注意:Sublime 自带的 Terminal 插件(如 Terminus)也能嵌入终端,但默认不继承虚拟环境变量,仍需手动激活或指定解释器。
调试时别依赖 Sublime 的 print(),优先用 logging 或 django-debug-toolbar
Sublime 没有原生 Python 调试器(不像 PyCharm),print() 输出会混在构建结果里,且无法查看对象结构。实际开发中更可靠的方式是:
- 在视图或模型里加
import logging; logger = logging.getLogger(__name__),然后logger.debug("value: %s", obj) - 配合 Django 日志配置,输出到控制台或文件,比
print更可控 - 安装
django-debug-toolbar:它能在浏览器页面底部显示 SQL 查询、模板上下文、信号等,比在编辑器里“猜”逻辑高效得多
容易被忽略的一点:Django 的 DEBUG=True 下,runserver 会自动重载代码,但 Sublime 不会自动刷新浏览器。改完模板或静态文件后,得手动刷新页面——这不是配置问题,是工作流本身如此。










