Sublime的C++构建系统生效前提是在终端能直接运行g++，否则90%的“Ctrl+B没反应”或“command not found”问题均源于此；需按系统差异安装MinGW-w64（Windows）、Homebrew gcc（macOS）或build-essential（Linux/WSL2），并确保GUI启动的Sublime能继承PATH（如macOS/Linux从终端执行subl或open命令），构建文件必须用shell_cmd而非cmd数组，且macOS需明确使用g++-14而非g++。
Sublime 的 C++ 构建系统不会自动生效，必须先确保 g++ 在终端能直接运行，否则所有配置都白搭——这是 90% “Ctrl+B 没反应” 或 “command not found” 的真实原因。
确认 g++ 真正可用，不是“看起来可用”
Sublime 启动时（尤其是 GUI 方式）不读 ~/.zshrc、~/.bashrc 或 Windows 用户级环境变量。终端里能跑 ≠ Sublime 能调。
- Windows：装 MinGW-w64（不是老版 MinGW），安装时务必勾选 Add to PATH；装完后重启 CMD，执行
g++ --version必须有输出 - macOS：先
xcode-select --install，再brew install gcc；注意 Homebrew 安装的 GNUg++实际叫g++-14（版本号可能为 13/15），g++命令默认指向 Xcode 的clang++ - Linux / WSL2：
sudo apt install build-essential（Ubuntu/Debian）或sudo dnf groupinstall "Development Tools"（Fedora），再验证g++ --version - macOS/Linux 用户若用 GUI 启动 Sublime，应改从终端启动：
open -a "Sublime Text"或subl（需先配置 shell 命令）
C++.sublime-build 必须用 shell_cmd，别碰 cmd 数组
Windows 下 cmd 数组写法（如 ["g++", "$file", "-o", "$file_base_name"]）极易因路径含空格、中文、未继承环境变量而静默失败；shell_cmd 走系统 shell 解析，更稳。
- 推荐配置（保存为
Packages/User/C++.sublime-build）：{ "shell_cmd": "g++ -std=c++17 -Wall \"${file}\" -o \"${file_path}/${file_base_name}\"", "file_regex": "^(..[^:]*):([0-9]+):([0-9]+):? (.*)$", "working_dir": "${file_path}", "selector": "source.c++, source.cpp" } - macOS 用户必须把
g++换成g++-14（或你实际安装的版本），否则调用的是clang++，行为和报错格式可能不一致 -
file_regex必须严格匹配 GCC 默认报错格式，例如main.cpp:5:12: error:；错一个字符，双击错误行就跳不到源码
加 Run 变体让 Ctrl+Shift+B 直接运行，但别指望“不闪退”
控制台窗口立刻关闭不是构建系统问题，是程序退出即关窗——和 Sublime 无关。
立即学习“C++免费学习笔记（深入）”；
- 在
variants里加一个 Run：{ "name": "Run", "shell_cmd": "cd \"${file_path}\" && \"${file_path}/${file_base_name}\"" } - Windows 用户若想看到输出，得手动加
pause："shell_cmd": "cd \"${file_path}\" && start cmd /c \"\"${file_path}/${file_base_name}\" & pause" - macOS/Linux 用户可改用：
"shell_cmd": "cd \"${file_path}\" && \"${file_path}/${file_base_name}\" && read -p \"Press enter to continue\"" - 更干净的解法是在代码末尾加
std::cin.get();，等用户按回车才退出
多文件项目或头文件依赖时，别硬扛构建系统
Sublime 的构建系统天然不支持自动依赖分析和增量编译。它只适合单文件快速验证。
- 两个以上
.cpp文件？必须用Makefile或CMakeLists.txt，然后配一个调用make的构建系统 - 需要
#include <xxx>系统头？shell_cmd里得显式加-I参数，比如-I/usr/include/c++/14 - 交互式输入（如
std::cin >> x）无法在 Sublime 输出面板完成，必须去终端运行生成的可执行文件，或装Terminus插件
