Sublime Text本身不编译代码，只调用系统已安装的编译器；配置失败主因是GUI启动不继承终端PATH，90%问题源于环境变量未透传，须先验证g++/python在终端可执行，再配置shell_cmd和file_regex等构建参数。
Sublime Text 本身不编译代码，它只调用你系统里已装好的编译器；配置失败的主因永远是终端能跑 ≠ Sublime 能调，90% 的问题卡在 PATH 或 GUI 启动时环境变量未继承。
确认 g++/python 等命令在终端真实可用
别跳过这步——这是所有构建系统生效的前提。打开系统终端（CMD、Terminal 或 bash），直接执行：g++ --version 或 python3 --version。有版本输出才算通过。若报 command not found，说明编译器没装或没进 PATH，此时配任何 .sublime-build 都无效。
- Windows：MinGW-w64 安装时必须勾选 “Add to PATH”，装完重启 CMD 再试
- macOS：Homebrew 安装的 GCC 实际命令是
g++-14（版本号随 brew 更新变化），g++默认指向 Xcode 的 clang++，构建系统里得写对名字 - Linux/WSL2：用
sudo apt install build-essential（Debian/Ubuntu）或sudo dnf groupinstall "Development Tools"（Fedora），再验证g++ --version - 关键细节：Sublime 通过 GUI 启动（比如双击图标）时，不会加载 ~/.zshrc 或 ~/.bashrc 中的 PATH 设置，即使你在终端里 export 过变量也没用
用 shell_cmd 而不是 cmd 数组写构建系统
尤其 Windows 下，cmd 数组写法（如 ["g++", "-o", "$file_base_name", "$file"]）极易因路径含空格、环境变量未继承、&& 不被识别而静默失败。改用 shell_cmd 直接走 shell 解析，更鲁棒。
- 推荐写法（保存为
Packages/User/C++.sublime-build）："shell_cmd": "g++ -std=c++17 -Wall \"${file}\" -o \"${file_path}/${file_base_name}\"" -
shell_cmd在 Windows 不需要加"shell": true（默认启用），但前提是g++确实在 CMD 中可直接调用 - macOS/Linux 用户若用 zsh/bash，
shell_cmd也能正确处理通配符、重定向和&&，比cmd数组更贴近实际开发习惯
file_regex 必须匹配真实报错格式才能双击跳转
如果编译出错后双击错误行不跳转到对应位置，大概率是 file_regex 没对上 GCC 实际输出。GCC 12+ 默认报错格式是 main.cpp:5:12: error:，正则必须严格匹配。
- 正确示例：
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):? (.*)$" - 错误常见点：漏掉冒号后的空格、把第 3 组数字写成可选（
[0-9]*）、没转义点号导致匹配失败 - 验证方法：手动在终端运行
g++ broken.cpp，看报错是否形如broken.cpp:3:10: error: ...，再对照正则调试
Run 变体里输出一闪而过不是构建系统问题
按 Ctrl+Shift+B 选 Run 后窗口闪退，不是 JSON 写错了，而是程序运行完就退出了。Sublime 底部面板不支持 stdin 输入，所以交互式程序必须另开终端。
- 安全做法（Windows）：
"shell_cmd": "cd \"${file_path}\" && start cmd /c \"\"${file_path}/${file_base_name}\" & pause\"" - macOS/Linux 推荐用插件
Terminus，配合"target": "terminus_exec"，能真正交互 - 临时调试可在代码末尾加
std::cin.get();（C++）或input()（Python），但别提交到正式代码里
最常被忽略的是 GUI 启动 Sublime 时 PATH 不继承——哪怕你 .zshrc 里写了 export，双击图标启动照样找不到 g++。解决办法要么改用终端启动 Sublime（subl 命令），要么把编译器绝对路径硬编码进 shell_cmd，或者在系统级环境变量里补全（Windows 系统属性 → 高级 → 环境变量；macOS 修改 /etc/paths）。
