g++必须在终端直接可用，否则Sublime Ctrl+B必失败；需验证PATH、重开Sublime、用shell_cmd、加-g、配file_regex、处理中文/空格路径，并将.build文件存至Packages/User/。
g++ 必须在终端里能直接调用，否则 Sublime 按 Ctrl+B 一定失败——这不是配置问题，是前置条件没满足。
确认 g++ 真正可用，不是“看起来可用”
Sublime 启动时不会自动加载你的 shell 配置（比如 ~/.zshrc 或 PATH 修改），GUI 启动的 Sublime 和终端里的环境可能完全不同。
- Windows：打开 CMD，运行
g++ --version；若报“不是内部或外部命令”，说明 MinGW-w64 的bin路径没进系统 PATH，或安装时没勾选 “Add to PATH” - macOS：终端里
g++ --version显示的是 clang++？那是 Xcode 自带的，不是 Homebrew 安装的 GNU GCC。得用g++-14 --version（版本号依brew install gcc实际安装而定）来验证，并在构建配置中写全名 - Linux / WSL2：运行
which g++，没输出就补装sudo apt install g++（别只装gcc） - 验证通过后，**关掉所有 Sublime 实例，再从开始菜单/启动器重新打开**——这是让新 PATH 生效的关键一步
C++.sublime-build 该用 shell_cmd 还是 cmd 数组？
Windows 下强烈推荐 shell_cmd，cmd 数组容易因路径含空格、&& 不识别、环境变量未继承而静默失败；macOS/Linux 两者都可，但 shell_cmd 对中文路径更稳。
- 正确示例（Windows/macOS/Linux 通用）：
"shell_cmd": "g++ -std=c++17 -Wall \"${file}\" -o \"${file_path}/${file_base_name}\"" - 错误写法：
"cmd": ["g++", "${file}", "-o", "${file_base_name}"]—— Windows 下不指定路径，生成的可执行文件默认落在 Sublime 安装目录，且后续Run变体找不到它 - 必须加
-g标志：哪怕暂时不调试，也建议加上-g，否则以后想用gdb或插件单步就只能重编译 -
file_regex必须严格匹配 GCC 报错格式："^(..[^:]*):([0-9]+):([0-9]+):? (.*)$"，少一个冒号或空格，双击错误行就跳不到源码
按 Ctrl+B 编译成功，但 Ctrl+Shift+B 运行后窗口一闪而过？
这不是构建系统 bug，是 Windows 控制台程序默认行为：进程结束，窗口立即关闭。解决方式只有两种，别指望底部面板支持 cin。
- 方案一（推荐）：在代码末尾加
std::cin.get();或system("pause");（仅 Windows） - 方案二（更干净）：用
variants启动外部终端："name": "Run", "shell_cmd": "cd \"${file_path}\" && start cmd /c \"${file_base_name} & pause\""
注意：macOS/Linux 用open -a Terminal.app或gnome-terminal替代 - 别用底部面板做交互输入：Sublime 的 build output panel 不提供 stdin 绑定，
cin或scanf会阻塞且无响应
中文乱码、路径含空格、Run 找不到生成文件？三个易漏点
这些问题往往同时出现，根因都在构建配置没处理好 shell 上下文和路径语义。
立即学习“C++免费学习笔记（深入）”；
-
shell_cmd中所有路径必须用英文双引号包裹："\"${file}\""，否则含空格路径（如C:\Users\My Name\code\test.cpp）直接崩 - Windows 下中文输出乱码：在
shell_cmd前加chcp 65001 &&，变成："shell_cmd": "chcp 65001 && g++ -std=c++17 ..." -
working_dir必须设为"${file_path}"，否则Run变体执行时 cwd 是 Sublime 启动目录，不是你的源码目录，自然找不到${file_base_name} - 保存构建文件时，务必存到
Packages/User/目录（可通过Preferences → Browse Packages…打开），放错位置 Sublime 就读不到
PATH，以及 Windows 下对路径空格和编码的零容忍。每次换电脑或重装系统，先在 CMD/终端里敲三遍 g++ --version，再动手写 .sublime-build。 
