Sublime自定义构建系统必须放在Packages/User/目录下，后缀为.sublime-build，其他位置如Packages/子目录、桌面或文档均无效。
构建系统文件存在哪里？
Sublime 的自定义构建系统必须放在 Packages/User/ 目录下，后缀为 .sublime-build，比如你写的 Python3-Output.sublime-build 或 NodeJS-Debug.sublime-build。它不会被识别、也不会生效，如果放在 Packages/ 下其他子目录（如 Packages/Python/）或桌面/文档等任意别处。
只备份 .sublime-build 文件还不够
一个构建系统能否正常运行，往往依赖其他配置协同：
-
Preferences.sublime-settings里可能设置了"fallback_encoding"或"default_exec_cmd"，影响输出解析 -
Package Control.sublime-settings若缺失，插件提供的命令（如Terminus的terminus_open）无法加载，导致构建系统中"cmd": ["terminus_open", "..."]报错 - 若构建系统调用了 Shell 脚本（如
"cmd": ["sh", "build.sh"]），该脚本本身不在Packages/User/内，需额外确认路径和权限 - 某些构建系统用到的语法高亮或作用域（如
"target": "exec"配合exec.py），实际来自 Sublime 核心或插件，不属用户配置，无需备份但需确保目标环境已安装对应插件
备份时最容易漏掉的三个细节
常见失效现象：迁移到新机器后构建系统出现在菜单里，但一运行就报 KeyError: 'cmd'、command not found 或面板空白无输出。
- 文件名含空格或中文——比如
My Build System (debug).sublime-build，在 macOS/Linux 下可能因 shell 解析失败；建议统一用英文+下划线，如python_debug_output.sublime-build - JSON 格式非法：末尾多逗号、用了单引号、写了
// 注释→ 整个文件被 Sublime 忽略，且控制台不报错 - 路径变量写死：
"cmd": ["python", "/home/user/project/main.py"]迁移后必然失败；应改用"$file"、"$file_path"、"$project_path"等内置变量
还原后验证构建系统是否真能用
别只看菜单里有没有名字。真实可用需满足：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Build With:，能列出你的构建系统名 - 选中运行后，底部面板弹出，且有明确输出（哪怕只是
[Finished]） - 如果构建系统调用外部命令（如
npm、rustc），确认目标机器 PATH 中已包含该命令——Sublime 不继承 shell 的完整环境，有时需在构建系统中显式指定"path": "/usr/local/bin:/opt/homebrew/bin"
构建系统是纯文本 JSON，但它活不活得起来，取决于变量、路径、依赖命令、插件状态这四层嵌套。少一层，就卡在“看起来对，其实动不了”。
