编译命令必须用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。
















