sublime text需系统级安装gcc并正确配置path；gui启动时不继承shell环境变量，须手动设置；构建系统需匹配gcc错误格式正则、添加暂停机制及头文件路径。
Sublime Text 本身不带 GCC 或任何编译器，所谓“安装 GCC”不是在 Sublime 里操作，而是必须在操作系统层面完成；配置环境的关键在于让 Sublime 能调用到你系统里已装好、且 PATH 可达的 g++（或 gcc）命令。如果终端里 g++ --version 都报错，所有 Sublime 配置都白搭。
g++ 命令在终端能跑，但 Ctrl+B 报 “command not found”
这不是 Sublime 配错了，是它没继承 shell 的 PATH 环境变量。GUI 启动的应用（比如从开始菜单、Dock 或桌面图标打开的 Sublime）不会自动加载 ~/.zshrc、~/.bashrc 或 Windows 系统环境变量里的 PATH。
- Windows：MinGW-w64 安装时务必勾选 “Add to PATH”；若漏了，手动把类似
C:mingw64in的路径加进「系统环境变量」，加完重启 Sublime - macOS：Homebrew 安装的 GCC 实际可执行文件名是
g++-14（2026 年主流），不能写g++；构建系统里得明确用"cmd": ["g++-14", ...] - Linux / WSL2：确认运行的是 Linux 版 Sublime（不是 Windows 版），否则无法调用 WSL 内的
g++ - 验证方式：在 Sublime 中按
Ctrl+`打开内置终端，直接输入g++ --version—— 如果这里也失败，说明 PATH 没生效，别往下配
构建系统中 file_regex 不匹配，双击错误行不跳转
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:行号:列号:这种结构；不匹配就调正则
编译成功但程序一闪而过，看不到输出
Sublime 构建系统默认不暂停控制台，C++ 控制台程序执行完立刻退出，输出面板只闪一下就清空。这不是编译失败，只是太快。
- 最简单可靠办法：在
main()结尾加一行std::cin.get();，等用户按回车再退出 - 别用
system("pause")——它在 macOS/Linux 下无效，且有安全风险 - 想全自动停留：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数组不支持
真正容易被忽略的点是：构建系统里的 working_dir 和 ${file_path} 是当前源文件所在目录，不是项目根目录；如果你的 #include "xxx.h" 是相对路径，且头文件不在同级目录，就得显式加 -I 参数，比如 "cmd": ["g++-14", "-I", "./inc", "${file}", "-o", "${file_path}/${file_base_name}"]——否则编译会静默失败或报 fatal error: xxx.h: No such file or directory。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
