build system 文件必须放在 packages/user/ 目录下才生效；sublime text 仅从此路径加载 .sublime-build 文件，其他位置如桌面、项目根目录或 packages/ 子文件夹均无效，放错路径则菜单不显示且 ctrl+b 无响应。
Build System 文件必须放在 Packages/User/ 目录下才生效
Sublime Text 只加载 Packages/User/ 下的 .sublime-build 文件，其他位置——比如项目根目录、桌面、Packages/MyLang/——全都不识别。放错路径，菜单里根本不会出现该构建项，按 Ctrl+B 也毫无反应。
实操建议：
- 用菜单
Preferences → Browse Packages…直接打开Packages/目录，再进User/新建文件 - 文件名随意（如
Make_Run.sublime-build），但后缀必须是.sublime-build - 别双击桌面文件再拖进 Sublime 编辑——这样保存路径仍是桌面，不会自动移到
User/
多文件项目别硬写 cmd，优先用 make 或 cmake 驱动
直接在 cmd 或 shell_cmd 里拼接多个 .cpp 文件编译，容易漏依赖、路径错乱、重复编译。真正可维护的项目，应该交由 make、cmake --build 或 scons 处理，Build System 只负责调用它们。
常见错误现象：改了一个头文件，Ctrl+B 后没重新编译对应源文件；或报错 undefined reference 却找不到链接缺失点。
实操建议：
- Linux/macOS：用
"shell_cmd": "make -C $file_path"，配合项目根目录下的Makefile - Windows：若用 CMake，推荐
"cmd": ["cmake", "--build", "build", "--config", "Release"]，前提是已运行过cmake -S . -B build -
selector设为"source.makefile, source.c++, source.c"，让 Build System 在打开Makefile或源码时都能激活
shell_cmd 和 cmd 的选择取决于操作系统和命令复杂度
shell_cmd 是字符串，走系统 shell 解析（cmd.exe / bash），支持 &&、|、变量展开；cmd 是数组，绕过 shell，更安全但不支持管道和逻辑连接符。选错会导致命令静默失败或语法报错。
实操建议：
- Windows 下编译+运行连写（如
g++ a.cpp -o a && a）必须用shell_cmd；用cmd数组写会把&&当成参数传给g++，直接报错 - macOS/Linux 下推荐
cmd数组，避免 shell 版本差异（比如sh不兼容bash扩展）；若需重定向或管道，再切回shell_cmd - 所有含空格的路径（如
$file）在shell_cmd中必须用双引号包裹："shell_cmd": "g++ \"${file}\" -o \"${file_base_name}\""
交互式输入程序不能在 Sublime 输出面板里跑
Sublime 的构建输出面板是只读流，scanf、std::cin、input() 会立即阻塞并卡住，无法输入任何内容。这不是配置问题，而是架构限制。
实操建议：
- C/C++：用
shell_cmd调起终端，例如 Windows 写"shell_cmd": "start cmd /k g++ \"${file}\" -o \"${file_base_name}\" && \"${file_base_name}\"" - Python：避免在构建系统里直接
python "$file"，改用SublimeREPL插件，或终端手动执行 - Java：
java命令本身不支持 stdin 重定向到面板，同理需外接终端
最易被忽略的是 $file 变量——它只在文件已保存时展开为绝对路径；未命名或未保存的标签页，$file 为空字符串，整个命令就变成 g++ "" -o ""，报错却看不出原因。
