编译命令必须用cmd数组而非shell_cmd，因cmd不依赖shell解析、天然跨平台且能正确展开$file等变量；shell_cmd在Windows下无法识别变量，易报“不是内部或外部命令”。
编译命令必须用 cmd 数组，别碰 shell_cmd（除非你明确要链式执行）
Sublime 的 cmd 是安全跨平台的执行方式，它把每个参数作为独立字符串传给系统，不经过 shell 解析；而 shell_cmd 是字符串，依赖当前 shell（Windows 默认是 cmd.exe，macOS/Linux 是 bash/zsh），$file 在 Windows 的 cmd.exe 里根本不会展开，直接报 “不是内部或外部命令”。
常见错误现象：配置了 "shell_cmd": "g++ $file -o $file_base_name"，Ctrl+B 后毫无反应或弹出错误窗口。
- ✅ 正确写法（推荐所有场景）：
"cmd": ["g++", "-std=c++17", "-Wall", "$file", "-o", "$file_base_name"] - ⚠️ Windows 下若真要用
&&链式执行（如编译+运行），必须加"shell": true，且确保终端是 PowerShell（cmd.exe 不支持&&） - ❌ 别写
"cmd": "g++ $file -o $file_base_name"—— JSON 要求数组，字符串会静默失败
变量只在 cmd 或 shell_cmd 里生效，working_dir 里写 $file_path 是无效的
$file、$file_path、$file_base_name 这些变量仅在 cmd 数组元素中或 shell_cmd 字符串内被 Sublime 替换；写在 working_dir、encoding 等字段里，它们就是字面量，不会解析。
常见错误现象：构建后生成的 .exe 跑在错误目录，或找不到头文件/资源文件。
- ✅ 正确指定工作目录：
"working_dir": "$file_path"（这个字段本身支持变量，但仅限这几个标准变量） - ✅ 编译时引用当前路径：
"cmd": ["gcc", "-I", "$file_path/include", "$file"] - ❌ 错误示例：
"working_dir": "$file_path/subdir"中的$file_path不会被展开（Sublime 不做嵌套变量解析）
文件必须已保存，Untitled 标签页的 $file 是空字符串
Sublime 的构建变量全部基于磁盘路径。未保存的文件没有真实路径，$file 展开为空，命令变成类似 python "" 或 g++ ""，结果要么报错，要么静默失败。
常见错误现象：按 Ctrl+B 没输出、面板一闪而过、提示 “no input files” 或 “cannot open output file”。
- ✅ 每次构建前务必先保存：Ctrl+S（Windows/Linux）或 Cmd+S（macOS）
- ✅ 新建 C 文件后，先存为
test.c，再选 Build System，再 Ctrl+B - ❌ 不要依赖 “自动保存” 插件——Build System 不感知插件行为，只看文件是否写入磁盘
selector 决定构建系统是否自动激活，不是看后缀名而是看语法 scope
Sublime 不靠 .cpp 后缀匹配构建系统，而是靠当前视图的 syntax scope。比如一个 .cpp 文件如果手动设成了 Plain Text，它的 scope 就是 text.plain，哪怕你写了 "selector": "source.cpp" 也不会触发。
常见错误现象：菜单里能看到构建系统，但新建 .cpp 文件后右下角没自动选中，Ctrl+B 也不响应。
- ✅ 查看当前 scope：按 Ctrl+Shift+P（Win）或 Cmd+Shift+P（Mac），输入
Inspect Scope，看第一行输出（如source.cpp） - ✅ 常见 scope 值：
source.c、source.cpp、source.python、source.java - ❌ 别写
"selector": ".cpp"或"selector": "cpp"—— 这种写法完全不生效
文件路径含空格、中文、特殊字符时，cmd 数组天然免疫；但如果你非要用 shell_cmd，就得自己加双引号并转义，这一步极易出错。真正省事的办法，从来不是“怎么修 shell_cmd”，而是直接用 cmd。
