Sublime项目级构建系统必须依托已保存的.sublime-project文件，未执行Project → Save Project As…则该文件不存在，build_systems配置无法生效；保存后需在Tools → Build System中手动选择对应项，且命令执行依赖Sublime启动时继承的PATH环境变量。
项目没保存，.sublime-project 就不存在，构建系统根本配不进去
Sublime 的项目级构建系统必须依托 .sublime-project 文件，而这个文件只有显式保存项目后才会生成。没点过 Project → Save Project As…，所有写进项目设置的 build_systems 都是空谈。
常见错误现象：改了项目文件、加了 build_systems 数组，但 Tools → Build System 里始终看不到新选项——大概率是项目根本没保存，或者保存路径被误选为只读目录（比如系统根目录、网络挂载盘）。
- 先确认菜单栏 Project 右侧是否显示项目名（如
my-api.sublime-project），没显示就说明当前是“无项目”状态 - 保存时建议用英文名+短横线，避免空格或中文路径导致某些插件解析失败
- 保存后检查文件内容，确保顶层有
"build_systems"字段，且是合法 JSON 数组
build_systems 里怎么写才能让 Ctrl+B 直接跑对命令
项目配置中的 build_systems 是一个数组，每项是一个完整构建定义，它和全局 .sublime-build 文件结构一致，但字段必须全写在项目文件里，不能引用外部文件。
关键字段不能漏：name（菜单中显示名）、cmd 或 shell_cmd（执行命令）、working_dir（推荐 "$project_path"）、selector（可选，控制自动匹配）。
- 如果想在项目根目录下运行
npm run dev，写成："cmd": ["npm", "run", "dev"]，并设"working_dir": "$project_path" - 若依赖 shell 特性（如管道、通配符），改用
"shell_cmd": "npm run dev 2>&1"，但注意 Windows 和 macOS/Linux 的 shell 差异 -
selector不填也行，但填了（如"source.js"）后，Ctrl+B 在非 JS 文件里就不会触发该构建，适合语言专用任务
为什么命令执行了却看不到输出，或者报 Cannot find command 'python'
这不是构建系统写错了，而是 Sublime 没继承你终端里的环境变量——尤其 macOS 上从 Dock 启动 Sublime 时，PATH 通常极简，连 /usr/local/bin 都没有，更别说 python3 或 node 的路径。
典型表现：你在 iTerm 里能跑 python3 --version，但在 Sublime 构建系统里提示 command not found；或者命令一闪而过，输出面板只显示 [Finished in 0.02s]，没任何结果。
- 最可靠解法：从终端启动 Sublime，比如
subl .（macOS）或subl（Linux），这样它会复用当前 shell 的 PATH - Windows 用户注意：PowerShell 和 cmd 的 PATH 可能不同，Sublime 默认可能调用 cmd，如果
node只在 PowerShell 里可用，就得在构建系统里显式调用："shell_cmd": "powershell -Command \"node $file\"" - 临时验证 PATH：在构建系统里加一条
"cmd": ["sh", "-c", "echo $PATH"]，看输出是否包含你预期的路径
多个构建任务共存时，怎么避免按 Ctrl+B 总是触发错的那个
Sublime 默认只会把第一个 build_systems 项作为“默认构建”，但如果你没手动选中，它可能回退到全局的 Python 或其他语言构建系统，而不是你项目里定义的。
真正生效靠的是两层匹配：先看当前文件是否满足某个构建的 selector，再看有没有显式选中某项。两者都未命中，就用第一个数组项。
- 务必在 Tools → Build System 菜单里手动点一次你项目里的构建名（比如
Run API Server），之后 Ctrl+B 才会固定走它 - 如果项目里混着 Python 和 Shell 脚本，建议给每个构建明确
selector，比如"source.python"和"source.shell"，防止误触发 - 想一键切换，可以加
variants：比如主构建叫Build，变体叫Build with Tests，这样按 Ctrl+Shift+B 就能唤出变体菜单
