Sublime中manage.py报No module named 'django'错误,根本原因是构建系统未使用虚拟环境Python解释器;须手动创建Django.sublime-build指定venv路径,而非双击启动或依赖系统Python。

Sublime 里 manage.py runserver 报 No module named 'django'
不是 Django 没装,是 Sublime 的构建系统没走你的虚拟环境。双击图标启动 Sublime 时,它不读 shell 的 ~/.zshrc 或 venv 激活状态。
必须显式指定解释器路径:
- 打开
Tools → Build System → New Build System - 填入类似内容(Linux/macOS):
{ "shell_cmd": "/path/to/your/venv/bin/python ${project_path}/manage.py runserver", "working_dir": "${project_path}", "file_regex": "^[ ]*File "(.+?)", line ([0-9]+)" } - Windows 用户路径写成:
C:\path\to\venv\Scripts\python.exe,注意双反斜杠 - 保存为
Django.sublime-build,再在右下角构建系统菜单中选它
别用 python manage.py 这种写法——它永远调系统 Python,不是你的 venv。
urls.py 里 path() 跳不到对应视图函数
Sublime 原生不解析 Django 路由映射,Ctrl+Click 点 path('user/', views.user_list) 不会跳转到 user_list 定义处。
轻量级解法靠 Goto Symbol(不是 Goto Definition):
- 确保当前文件是
views.py - 按
Ctrl+R(macOSCmd+R),输入def user_list或正则defs+(w+) - 如果视图是类视图,搜
classs+(w+)
别指望插件自动建立路由→视图索引;Djaneiro 提供的 snippets 和高亮不包含符号跳转能力。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
模板里 {% url %} 和 {% static %} 一直是灰色
这不是配置错,是 Sublime 语法高亮的硬限制:它用静态正则匹配,无法解析 {% load static %} 动态引入的标签库。
所以以下全是正常现象:
-
{% load static %}高亮,但后续{% static "css/app.css" %}仍是灰色 -
{% url 'user_detail' pk=1 %}中的user_detail不变色 -
{{ user.profile.avatar }}在 Djaneiro 下能分层着色(user、profile、avatar各不同色),但{% static %}就是纯文本色
接受它——语义简单,不影响运行;想高亮就得改 .sublime-syntax 文件,但每次插件更新会被覆盖,不值得。
settings.py 和 models.py 语法识别异常
Sublime 不按项目结构自动设语法:settings.py 可能被当成纯文本,models.py 里字段定义缩进错乱,常因语法识别失败导致。
手动且精准地设语法:
- 打开
settings.py→View → Syntax → Python,或快捷键Ctrl+Shift+P输入Set Syntax: Python - 同理对
models.py、views.py、urls.py全部手动设一次 - 更一劳永逸:在项目根目录建
.sublime-project,写入{ "folders": [{ "path": "." }], "settings": { "syntax": "Packages/Python/Python.sublime-syntax" } }
别用旧版 Python.tmLanguage,Sublime Text 4+ 已弃用,会导致 async/await 高亮异常。


















