sublime text 无法一键运行 c/c++ 的根本原因是 gui 启动时不继承 shell 的 path 环境变量，导致找不到 g++；需确保系统级环境变量配置正确、构建系统中指定准确的编译器名（如 g++-14）、启用 "shell": true（windows）、使用正确的 file_regex 正则匹配错误格式，并在 main 中添加 std::cin.get() 防止程序闪退。
Sublime Text 本身不带编译器，所谓“一键运行 C/C++”只是调用你系统里已装好的 gcc 或 g++；如果 g++ --version 在终端能跑通，但在 Sublime 里按 Ctrl+B 报 command not found: g++，那问题 100% 出在环境变量没继承上——不是配置写错了，是 Sublime 根本没看到你的 PATH。
为什么终端能用 g++，Sublime 却找不到
GUI 应用（比如从 Dock、开始菜单或桌面图标启动的 Sublime）不会自动加载 shell 的配置文件（如 ~/.zshrc 或 PATH），哪怕你在终端里执行 echo $PATH 看到 mingw64\bin，Sublime 也完全不知道。
- Windows：MinGW-w64 安装时务必勾选 “add to PATH”，漏了就手动把类似
C:\mingw64\bin加进「系统环境变量」 - macOS：用
brew install gcc后，g++实际叫g++-14（2026 年主流），构建系统里必须写成"cmd": ["g++-14", ...] - Linux / WSL2：确认你运行的是 Linux 版 Sublime（不是 Windows 版），否则无法调用 WSL 内的
g++ - 验证方法：在 Sublime 内置终端（
Ctrl+`）里直接敲g++ --version，失败就说明环境变量没生效，得重启 Sublime 或改用命令行启动（如subl .）
Windows 下 .sublime-build 文件必须设 "shell": true
MinGW-w64 的 g++ 是个批处理包装器（尤其新版），不走 shell 就可能找不到依赖 DLL 或解析不了路径。很多配置只写 "cmd" 数组却没加 "shell": true，结果报错 Invalid argument 或静默失败。
-
"cmd"字段必须是数组格式：["g++", "-o", "${file_base_name}.exe", "${file}"]，不能写成字符串 - Windows 必须加
"shell": true，否则g++可能因路径含空格或缺少 cmd.exe 环境而崩溃 - 输出文件名建议带
.exe后缀："${file_base_name}.exe"，避免双击时系统不认识 - 别用
system("pause")停留——它在非 Windows 平台无效，且有安全风险；用std::cin.get()更稳妥
file_regex 写错，双击错误就跳不到代码行
GCC 12+ 默认错误格式是 main.cpp:5:12: error:（三段冒号分隔），但网上大量旧配置用空格或少一个冒号，一错就导致错误信息变成纯文本，没法双击定位。
- 推荐正则：
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):\s+(error|warning):\s+(.*)$" - 别删
file_regex字段——没它，错误堆在底部面板里，点不动也跳不了 - 验证方法：故意写个语法错（比如
int x = ;），编译后看输出是否含xxx.cpp:行号:列号:这种结构，再微调正则 - 注意 macOS/Linux 下路径可能含空格或中文，
file_regex中的^..[^:]*能匹配多级路径，比简单^([^:]+)更鲁棒
编译成功但程序一闪而过，其实是执行完就退出了
Sublime 构建系统默认不暂停控制台，C++ 控制台程序执行完立刻关闭，面板只闪一下就清空，你以为失败了，其实只是太快。
- 最简单办法：在
main()结尾加一行std::cin.get();，等用户按回车再退出 - 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 不建议用
cmd /c pause嵌套太深，容易卡住；优先用std::cin.get() - 如果项目要调试，记得加
-g参数，否则 GDB 找不到符号信息
最容易被忽略的是：构建系统里的 g++ 名字、file_regex 格式、以及 GUI 应用不继承 shell PATH 这三点，它们共同导致“明明终端能跑，Sublime 就不行”。配完别急着写代码，先用一行 int x = ; 测试报错跳转，再用 std::cout + <code>std::cin.get() 确认输出停留——这两步过了，才算真通了。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
