Sublime Text构建系统默认仅编译当前文件，多文件需手动列出或借助make/cmake；$file是唯一可靠变量，路径含空格须加双引号，working_dir、file_regex和PATH配置错误是静默失败主因。
构建系统默认只处理当前文件，多文件必须显式指定
Sublime Text 的 build system 本身不自动扫描项目目录或依赖关系。你打开 main.cpp 按 Ctrl+B，它只会把 $file（即当前文件路径）传给编译器——不会管同目录下的 utils.cpp 或 header.h。想编译多个源文件，就得在 cmd 或 shell_cmd 里手动列出，或者用构建工具接管。
-
$file是唯一保证可用的变量；$file_path、$file_name等也有效，但不能自动展开为“所有 .cpp 文件” - 不要指望
"selector": "source.cpp"能触发批量编译——它只控制菜单显示时机，和执行逻辑无关 - 如果项目已有
Makefile或CMakeLists.txt，优先走make或cmake --build，比手写文件列表更可靠
用 shell_cmd 手动拼接多文件编译命令（适合小项目）
适用于 3–5 个源文件、无复杂依赖的小型 C/C++ 工程。关键是把所有 .cpp 路径一次性塞进 g++ 命令，避免分步编译导致的符号未定义错误。
- Windows 下用
shell_cmd："shell_cmd": "g++ -std=c++17 "${file_path}/${file_base_name}.cpp" "${file_path}/utils.cpp" "${file_path}/io.cpp" -o "${file_path}/${file_base_name}.exe"" - macOS/Linux 下注意引号和空格：
"shell_cmd": "g++ -std=c++17 "${file_path}/${file_base_name}.cpp" "${file_path}/utils.cpp" -o "${file_path}/${file_base_name}"" - 路径含空格必须用双引号包裹
${file_path}和每个文件名，否则 shell 解析失败 - 别用
cmd+shell: true混搭——cmd是数组格式，不支持 shell 特性（如&&、管道），容易卡在中间步骤
用 make 或 cmake 替代手写命令（推荐中大型项目）
一旦文件数超过 5 个，或出现头文件依赖、条件编译、不同构建目标（debug/release），硬编码路径就不可维护。这时应让 make 或 cmake 处理依赖解析，Sublime 只负责调用。
- 确保
Makefile在项目根目录，且working_dir设为"${project_path}"或"${file_path}"（取决于 Makefile 位置） - 基础配置示例：
"shell_cmd": "make", "working_dir": "${project_path}", "file_regex": "^(.+?):([0-9]+):([0-9]+):? (.*)$" - 要支持
make clean等变体，必须用variants字段，且cmd值严格匹配 Makefile 中的目标名（如"clean"，不是"Clean"或"make clean"） - Windows 用户若用
mingw32-make，shell_cmd得写成"mingw32-make"，且 PATH 必须包含其所在目录，或直接写死"path": "C:\MinGW\bin"
常见失效原因：working_dir 错位、file_regex 不匹配、环境变量丢失
即使命令语法正确，构建系统仍可能静默失败或报错跳转失效。最常被忽略的是这三个点：
-
working_dir错了：比如Makefile在./build/下，但working_dir还是"${file_path}"，make就找不到规则 -
file_regex对不上编译器输出：GCC 默认报错是main.cpp:12:5: error:，但某些 MinGW 版本输出是main.cpp:12: error:（缺列号），原正则会失效；稳妥写法："file_regex": "^(.+?):([0-9]+):(?:[0-9]+)?:?\s+(.*)$" - Sublime 启动时没继承终端的 PATH：你在 Terminal 里能跑
g++，但 Sublime 里报Unable to find command g++，说明它没读到你的 shell 配置；要么改系统级 PATH，要么在构建系统里加"path": "/usr/local/bin:/opt/homebrew/bin"（macOS）或"path": "C:\MinGW\bin"（Windows）
多文件协同不是靠“开启某个开关”，而是明确告诉构建系统：你要编译哪些文件、在哪执行、出错时怎么定位。路径、工作目录、正则匹配这三处一旦出错，整个流程就会断在看不见的地方。
