需先安装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免费学习笔记（深入）”；
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
常见问题：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 不会自动刷新浏览器。改完模板或静态文件后，得手动刷新页面——这不是配置问题，是工作流本身如此。
