Sublime Text Build System 无反应主因是路径错误或JSON语法错误；需放于User包内、用双引号、正确键名、环境变量及编码设置，并通过selector或多文件实现多项目构建。
Build System 为什么没反应？检查 sublime-build 文件路径和语法
Sublime Text 的 Build System 不执行，八成是文件没放对位置或 JSON 格式错了一处逗号。默认路径是 ~/Library/Application Support/Sublime Text/Packages/User/（macOS）或 %APPDATA%\Sublime Text\Packages\User\（Windows），必须以 .sublime-build 结尾，且文件名不能含空格或中文。
常见错误包括：
- 用单引号代替双引号 —— JSON 只认双引号，
'cmd': ['python', '$file']会直接静默失败 -
file_regex或working_dir拼错键名，Sublime 不报错但不生效 - 路径里用了
~，实际要写成$HOME（macOS/Linux）或%USERPROFILE%（Windows）
如何让 Build System 自动保存再运行？用 save_all_on_build 配合 variants
默认 Build System 不自动保存当前文件，容易跑旧代码。在 .sublime-build 里加 "save_all_on_build": true 即可，但它只对主构建生效。如果想区分「运行」和「调试」，得用 variants：
{
"cmd": ["python", "-u", "$file"],
"save_all_on_build": true,
"variants":
[
{
"name": "Debug",
"cmd": ["python", "-u", "-m", "pdb", "$file"]
}
]
}
这样 Ctrl+B 是普通运行，Ctrl+Shift+B 弹出菜单选 Debug，避免反复改配置。
Python 构建卡住或输出乱码？重点调 shell、encoding 和 env
尤其是 Windows 上用 Conda 或 pyenv 管理 Python 版本时，Build System 默认找不到你的解释器，或者终端编码不一致导致中文变 。
- 用绝对路径指定 Python：比如
"cmd": ["C:/Users/xxx/miniconda3/python.exe", "$file"] - 显式设编码：
"encoding": "utf-8"（Windows 命令行默认是 gbk） - 传环境变量：
"env": {"PYTHONIOENCODING": "utf-8", "PATH": "C:/xxx/miniconda3;C:/xxx/miniconda3/Scripts;$PATH"} - 加
"shell": true才能用&&连命令，但会丢失$file路径中的空格转义，慎用
多个项目需要不同构建逻辑？别硬塞 if-else，用 selector + 多个 Build System
一个 .sublime-build 文件没法根据文件类型动态切 Python/Node.js/Shell，Sublime 也不支持条件判断。正确做法是为每类场景单独建文件，并靠 selector 自动匹配：
比如新建 Python-Pipenv.sublime-build，内容里加：
{
"selector": "source.python",
"cmd": ["pipenv", "run", "python", "$file"]
}
再建一个 Shell-Bash.sublime-build，"selector": "source.shell.bash"。Sublime 启动时自动扫描 User/ 下所有 .sublime-build，按当前文件语法高亮类型决定显示哪个构建项。
真正容易被忽略的是：一旦设了 selector，这个 Build System 就不会出现在「Tools → Build System」的固定列表里，只能通过「Ctrl+Shift+P → Set Build System」按名称搜索，或者靠快捷键自动触发 —— 很多人配完发现菜单里找不到，其实是 selector 在起作用。
