最常见原因是.sublime-build文件未保存在Packages/User/目录下，文件名含空格或中文，或未重启Sublime；selector配置错误会导致无法匹配语法scope，而项目级生效需在.sublime-project中声明build_systems字段。
Build System菜单里看不到新建的选项
最常见原因是 .sublime-build 文件没放在正确路径：Sublime Text 只认 Packages/User/ 目录下的构建文件，其他位置（比如项目根目录、桌面、Packages/ 子目录）一概忽略。
实操建议：
- 用
Preferences → Browse Packages…打开真实路径，确认最终保存位置是User/xxx.sublime-build - Windows 路径通常是
%APPDATA%Sublime TextPackagesUser，macOS 是~/Library/Application Support/Sublime Text/Packages/User/ - 文件名不能带空格或中文，后缀必须是
.sublime-build（不是.json或隐藏的.sublime-build.txt） - 保存后重启 Sublime Text 或执行
Package Control: Satisfy Dependencies（部分版本需手动刷新）
多个语言共存时 build system 切换混乱
根本问题出在 selector 字段配置不当。没有 selector，所有构建系统都会出现在每种文件类型菜单里；写错 selector，则压根不显示。
实操建议：
- 打开目标文件（如
main.py），按Ctrl+Shift+P输入Syntax: Show Syntax，看输出的 selector 值（通常是source.python） - 在
.sublime-build中显式写入"selector": "source.python"，不要删掉它 - 需要跨语言生效？用逗号分隔：
"selector": "source.python, source.js" - 避免用
"selector": "source"这类宽泛值，否则 Python 构建项会在 .go 文件里弹出来干扰操作
切换 build system 后没反应或报错 “Unable to find command”
多数是 shell_cmd 或 cmd 里的路径错了，尤其在多 Python 版本、虚拟环境、跨平台场景下。
实操建议：
- 优先用绝对路径调用解释器，比如
"shell_cmd": "/opt/homebrew/bin/python3.11 -u "$file""，而不是只写python3 - 检查
working_dir是否设为"${file_path}"，否则相对路径导入会失败 - Windows 下注意反斜杠转义：
"shell_cmd": "C:\Python311\python.exe -u "$file"" - 加
"quiet": true可屏蔽无关输出，聚焦错误信息本身
如何让某个 build system 只对特定项目生效
不能靠 .sublime-build 文件本身限制——它全局可见。真正起作用的是项目级绑定：.sublime-project 文件中的 build_systems 字段。
实操建议：
- 先确保项目已保存为
.sublime-project（Project → Save Project As…），且和文件夹同级 - 编辑该文件，在顶层加字段：
"build_systems": [{ "name": "MyCustomPython" }] -
name必须和.sublime-build文件名一致（不含后缀），大小写敏感 - 这样即使全局有 10 个 Python 构建系统，打开这个项目后 Build System 菜单里只显示这一个
项目文件里 build_systems 和 Packages/User/ 下的 .sublime-build 是两层控制：前者决定“菜单里出现哪些”，后者决定“选中后实际执行什么”。漏掉任一环，切换就失效。
