能直接用g++ --version在终端输出版本号才说明编译器安装正确；否则Sublime配置再完善也无效，因其GUI启动不继承shell的PATH环境变量。
一个核心原则必须牢记：只有能在终端里直接敲出 g++ --version 并看到版本号，你的编译器才算真正装好了。否则，在 Sublime Text 里折腾再多配置，都只是对着空气操作，因为它根本找不到你的编译器。
g++ 命令在终端能跑，但 Ctrl+B 报 “command not found”
遇到这种情况，先别急着怀疑配置文件。问题根源通常在于：Sublime Text 作为一个图形界面应用，启动时并不会自动继承你在终端里设置好的 PATH 环境变量。也就是说，你在 ~/.zshrc 或 ~/.bashrc 里配置得再好，Sublime 也“看不见”。
- Windows 用户：安装 MinGW-w64 时，务必勾选 “Add to PATH” 选项。如果当时漏了，就得手动将类似
C:\mingw64\bin的路径添加到系统的环境变量中。 - macOS 用户：通过 Homebrew 安装 GCC 后，实际的编译器命令可能叫
g++-14（以2026年主流版本为例）。因此，在构建系统的配置文件里，就不能再写g++，而应该写成"cmd": ["g++-14", ...]。 - Linux/WSL2 用户：请确认你使用的是 Linux 版本的 Sublime Text。如果你在 WSL 子系统里用着 Windows 版的 Sublime，那它自然无法调用 WSL 环境里的
g++。
Build System 的 file_regex 不匹配，双击错误不跳转
编译出错后，点击错误信息却无法跳转到对应代码行？这十有八九是 file_regex 这个正则表达式和你本地 GCC 输出的错误格式对不上号。GCC 12 及更高版本默认的错误格式是 文件名:行号:列号: 错误类型: 描述（注意是冒号分隔）。很多网上流传的老配置，用的还是空格分隔或少一个冒号的旧格式，一旦不匹配，双击跳转功能就失效了。
- 推荐配置：试试这个更通用的正则表达式：
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):\s+(error|warning):\s+(.*)$" - 别删除这个字段：如果没有
file_regex，错误信息在输出面板里就只是纯文本，完全失去了快速定位的能力。 - 验证方法：故意在代码里写个语法错误（比如
int x = ;），然后编译。观察输出信息是否包含xxx.cpp:行号:列号:这样的结构，再据此微调你的正则表达式。
编译成功但看不到输出，或者程序一闪而过
这是新手最常遇到的困惑之一：明明编译成功了，为什么输出面板一闪就清空，什么结果都看不到？其实，程序已经执行完了，只是 Sublime 默认不会在程序结束后暂停控制台。对于控制台程序来说，运行结束就意味着窗口关闭，速度快到你反应不过来。
立即学习“C语言免费学习笔记（深入）”；
- 代码层面解决：最简单的办法是在
main()函数的末尾加一行std::cin.get();，让程序等待用户按一下回车键再退出。 - 避免使用 system(“pause”)：这个命令在 macOS 和 Linux 下无效，而且存在安全风险，不推荐作为通用解决方案。
- 构建系统层面解决：如果想一劳永逸，可以在构建系统配置中使用
"shell_cmd"配合&&来串联命令。例如在 Linux/macOS 下可以这样写："shell_cmd": "g++-14 \"${file}\" -o \"${file_path}/${file_base_name}\" && \"${file_path}/${file_base_name}\" && echo '--- Press Enter to exit ---' && read -n1"。这样编译后会自动运行程序，并在结束后等待按键。 - Windows 用户注意：只有
shell_cmd字段支持使用&&连接多个命令，传统的cmd字段是不支持的。
为什么 .c 文件用 C++ Build System 编译会出怪错？
如果你用 C++ 的构建配置去编译一个 .c 后缀的 C 语言文件，很可能会遇到各种奇怪的错误。这是因为 g++ 编译器默认会将 .c 文件当作 C++ 源码来处理，从而启用了 C 语言中没有的特性（如 bool 类型、nullptr、函数重载等），导致编译失败或运行时行为异常。
- 正确做法：为 C 语言单独创建一个构建系统。在配置中，将
"cmd"改为gcc，并将"selector"设置为"source.c"，这样它就会专门处理 C 文件了。 - 别图省事：不要试图用一个配置通吃两种语言，比如把
"selector"写成"source.c, source.cpp"。这会导致gcc去编译.cpp文件，或者让g++去编译.c文件，两边都容易出问题。 - 中文路径问题：如果你的文件名或文件路径包含中文，很可能会触发
fatal error: no input files这类编码相关的错误。在开发阶段，全程使用英文名和下划线，是最能避免麻烦的务实选择。
说到底，配置 Sublime Text 编译环境时，真正卡住人的往往不是 JSON 语法本身。关键在于弄明白三件事：编译器命令在 Sublime 的上下文中能否被正确调用、编译器的错误输出格式是否被构建系统准确捕获、以及程序的运行结果有没有被输出窗口“吞掉”。把这三点捋清楚，比反复修改配置文件要有效得多。
