sublime如何配置Django开发环境_sublime运行Python框架设置【指南】

需先安装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）或 myenvScriptsactivate（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 不会自动刷新浏览器。改完模板或静态文件后，得手动刷新页面——这不是配置问题，是工作流本身如此。