Sublime Text 找不到编译系统,99% 是因文件未放在 Packages/User/ 目录下;cmd 必须为数组格式且路径正确;selector 需匹配语法作用域(如 source.python);虚拟环境需手动指定 python 可执行文件路径。

Sublime Text 找不到编译系统,99% 是因为文件根本没放对位置——它只认 Packages/User/ 目录下的 .sublime-build 文件,其他地方全无效。
Build System 文件必须放在 Packages/User/ 目录下
Sublime Text 启动时只扫描固定路径:Packages/User/。放桌面、项目根目录、Packages/MyLang/ 或任何其他子目录,都不会被加载,菜单里也不会出现对应项,按 Ctrl+B 更是毫无反应。
实操建议:
- 用菜单
Preferences → Browse Packages…直接打开Packages目录,再进User子文件夹 - 新建文件后,务必在此目录下保存,文件名任意但后缀必须是
.sublime-build(例如Python3.sublime-build) - 别用其他编辑器改完再拖进来——路径可能没变,仍不在
User下 - Windows 路径通常是
%APPDATA%\Sublime Text\Packages\User\;macOS 是~/Library/Application Support/Sublime Text/Packages/User/
cmd 字段写错导致构建静默失败
即使文件放对了,cmd 写法不对也会让构建“看起来存在但实际不工作”:终端一闪而过、无输出、报 Unable to find command python3 等。
核心规则:
-
cmd是数组,不是字符串:"cmd": ["python3", "-u", "$file"]✅;"cmd": "python3 -u $file"❌ - Windows 路径含空格必须加双引号,且推荐用正斜杠避免转义问题:
"C:/Program Files/Python312/python.exe"✅;"C:\Program Files\Python312\python.exe"❌(反斜杠需双写,易漏) - 绝对路径必须指向
python.exe(Windows)或可执行的python3(macOS/Linux),不能是pythonw.exe(GUI 版本会屏蔽 stdout) - 必须带
-u参数,否则print()缓冲不刷新,input()会卡住
selector 不匹配就自动失效
selector 不是文件后缀,而是 Sublime 的语法作用域(scope)。比如 Python 文件的作用域是 source.python,不是 .py。匹配不上,即使你打开的是 test.py,该构建系统也不会被自动选中,甚至不会出现在菜单里。
怎么查?
- 打开目标文件(如
main.py),把光标放在代码里 - 按
Ctrl+Shift+P(Windows)或Cmd+Shift+P(macOS),输入Inspect Scope回车 - 看底部状态栏显示的实际 scope,常见值:
source.python、source.c、source.shell - 确保你的
.sublime-build中"selector": "source.python"和这个值一致
虚拟环境或非默认 Python 怎么切?
你在终端里 source venv/bin/activate 后能 import requests,但 Sublime 里报 ModuleNotFoundError,说明构建系统还在调全局解释器。
解决方法很直接:
- 先在终端激活环境,再运行
which python(macOS/Linux)或where python(Windows) - 拿到真实路径,比如
./venv/bin/python或.\venv\Scripts\python.exe - 把这个路径填进
cmd第一项,而不是系统默认的/usr/bin/python3或C:\Python312\python.exe - 别信插件“自动识别”,2026 年主流方案仍是手动写死路径
容易被忽略的一点:多个 .sublime-build 文件可以共存,但每个都必须独立满足路径、JSON 格式、selector、cmd 四个条件——少一个,就等于没配。











