sublime text 不能直接运行 django 项目，因其仅为文本编辑器，无内置 python 解释器或 django 环境，需在终端执行 django-admin 或 python manage.py 命令；它仅支持语法高亮、跳转定义及调用外部终端等辅助功能。
Sublime Text 能不能直接运行 Django 项目
不能。Sublime Text 是纯文本编辑器，没有内置 Python 解释器或 Django 运行时环境，django-admin startproject 或 python manage.py runserver 这类命令必须在终端里执行，Sublime 本身不接管进程生命周期。
它能做的只有：高亮 Django 模板语法、跳转到视图/模型定义、用插件调起外部终端执行命令——本质是“更好的记事本”，不是 IDE。
常见错误现象：ImportError: No module named django 或 Command not found: python，基本都是因为 Sublime 启动的 shell 没加载你的虚拟环境或 PATH。
- 确认你已在终端中激活虚拟环境（如
source venv/bin/activate），再从该终端启动 Sublime：subl . - 不要双击图标启动 Sublime，否则它继承的是系统默认 shell 环境，大概率找不到
django - Mac 用户尤其注意：GUI 应用（包括 Sublime）默认不读取
~/.zshrc或~/.bash_profile，必须从终端启动才能继承变量
怎么让 Sublime 正确识别 .html 文件为 Django 模板
默认打开 index.html 时，Sublime 用的是 HTML 语法高亮，{{ }}、{% %} 这些 Django 模板语法不会被识别，补全和括号匹配也失效。
立即学习“Python免费学习笔记（深入）”；
解决方式不是装“Django 插件”，而是切换语法模式：
- 菜单栏 → View → Syntax → Django HTML（如果没看到，说明还没安装对应语法包）
- 推荐安装
Package Control后搜索安装Djaneiro或SublimeDjango，它们提供Django HTML语法定义和基础片段 - 别装太多“Django 全能插件”——很多年没更新，会和 Sublime 4 冲突，反而导致
Ctrl+Click跳转失效
注意：Django HTML 仅影响模板文件；.py 文件里的视图逻辑仍由 Python 语法高亮，无需额外配置。
用 Build System 快速运行 manage.py 命令靠谱吗
可以临时用，但别依赖。Sublime 的 Build System 本质是把命令扔给 shell 执行，适合 python manage.py makemigrations 这类短命命令，不适合 runserver。
常见错误现象：KeyboardInterrupt 不生效、端口占用不提示、日志刷屏后无法滚动查看——因为 Sublime 的 build output 面板不是真正的终端，缺少交互能力。
- 如果真要配 Build System，建一个
Python - Django构建文件，内容指定cmd为["python", "manage.py", "$1"]，再绑定快捷键，只用于迁移、shell、createsuperuser -
$1是占位符，运行时手动输入子命令（如runserver），但输错就报错，不提示可用命令 - 永远别在 Build System 里写死
runserver——它会卡住构建面板，后续所有操作都得重启 Sublime
真正省事的做法：开个独立终端窗口放 runserver，Sublime 专心写代码，用 Cmd+Shift+P → Terminal: New Terminal（需装 Terminus 插件）快速唤起同路径终端。
为什么 Ctrl+Click 跳转不到 models.py 里的类
Sublime 默认不索引项目符号，Ctrl+Click（或 Cmd+Click）跳转依赖 CTags 或语言服务器（LSP），而 Python 生态里 LSP 支持需要额外配置。
原生 Sublime 对 Django 的跨文件引用识别很弱，尤其涉及 from myapp.models import Xxx 这种相对导入，或 settings.INSTALLED_APPS 动态注册的应用。
- 最简方案：装
SublimeJEDI（轻量）或LSP-pyright（推荐），后者需先pip install pyright，再在 LSP 设置里指定"enabled": true和"settings"中的"python.defaultInterpreterPath" - 确保
manage.py和settings.py在项目根目录，LSP 才能正确推导INSTALLED_APPS路径 - 跳转失败常见原因：模型类名拼错、
__all__未导出、用了字符串引用（'auth.User'）而非真实 import ——这些不是编辑器问题，是 Django 自身限制
复杂点在于：Django 的动态特性（如 get_model()、apps.get_model()）天然无法被静态分析覆盖，这时候跳转失效是正常的，不是配置没到位。
