Sublime Text本身不编译C++，仅调用系统g++或clang++；90%配置失败源于PATH未被继承、编译器名不符（如macOS的g++-14）或Windows下PowerShell不支持&&，需通过终端实测g++ --version验证，并用shell_cmd方式配置含正确file_regex和编码的C++.sublime-build文件。
Sublime Text 本身不编译 C++，它只调用你系统里已安装的 g++ 或 clang++；配置失败 90% 是因为终端能跑、Sublime 跑不了——根本原因通常是 PATH 没继承、编译器名不对、或 Windows 下用了 PowerShell 默认 shell。
验证 g++ 是否真可用（不是“看起来可用”）
别信“我装过 MinGW”，得在 Sublime 的构建环境里实测。打开 Sublime → Tools → Command Palette（Ctrl+Shift+P），输入 Terminal，选 Open Terminal at File，然后直接敲：
g++ --version
如果报 command not found，说明 Sublime 启动时没拿到你的 PATH —— 即便 CMD 或 PowerShell 里 g++ --version 成功也不代表 Sublime 能用。
- Windows：确认 MinGW-w64 的
bin目录（如C:mingw64in）已加进「系统环境变量」PATH，不是用户变量 - macOS：Homebrew 安装的 GCC 常叫
g++-14，终端里g++ --version可能是 Clang 的 alias；实际得用g++-14 --version - Linux/WSL2：确保用的是 Linux 版 Sublime（不是 Windows 子系统里跑 Windows 版），且
sudo apt install build-essential已执行
写一个真正能跑的 C++.sublime-build（shell_cmd 方式）
别用 Sublime 自带的默认 C++ 构建系统，它在 Windows 上默认用 PowerShell，而 && 在 PowerShell 里不认；macOS/Linux 用 shell_cmd 最省心。
立即学习“C++免费学习笔记（深入）”；
新建构建系统（Tools → Build System → New Build System…），粘贴以下内容并保存为 C++.sublime-build（路径必须是 Packages/User/）：
{
"shell_cmd": "g++ -std=c++17 -Wall "${file}" -o "${file_path}/${file_base_name}" && "${file_path}/${file_base_name}"",
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):? (.*)$",
"working_dir": "${file_path}",
"selector": "source.c++, source.cpp",
"encoding": "UTF-8"
}
-
shell_cmd里用&&保证只在编译成功后才运行，避免残留旧可执行文件被误执行 - Windows 用户若仍报错，把
g++换成绝对路径，例如"C:\mingw64\bin\g++.exe"（注意双反斜杠） - macOS 用户若
g++指向 Clang，把g++改成g++-14（版本号按ls /usr/local/bin/g++*实际输出填） -
file_regex必须匹配 GCC 12+ 默认错误格式（main.cpp:5:12: error:），否则双击错误行不会跳转
解决输出一闪而过或中文乱码
Sublime 底部 panel 是非交互式终端，std::cin 会直接卡住，printf("你好") 可能显示方块——这不是代码问题，是环境缺失。
- 防闪退：在
main()结尾加std::cin.get();或system("pause");（仅 Windows） - Windows 中文输出：编译时加
-fexec-charset=GBK，即把shell_cmd中的编译部分改成：g++ -fexec-charset=GBK -std=c++17 ... - UTF-8 文件含 BOM：Sublime 保存时选 File → Save with Encoding → UTF-8（不要选 “UTF-8 with BOM”）
- Linux/macOS 中文：确保终端 locale 是
en_US.UTF-8或zh_CN.UTF-8，用locale命令确认
多文件项目别硬扛构建系统
一个 .sublime-build 文件最多处理单个 .cpp 文件。一旦出现 #include "xxx.h" 或多个 .cpp，就别折腾 shell_cmd 拼命令了。
- 正确做法：根目录下写
Makefile，构建系统里只调用make - 示例
shell_cmd："make -C "${file_path}""，配合working_dir指向项目根 - 更稳的选择：直接切到终端，
cd到项目目录，手动make；Sublime 就专心写代码 - 想调试？SublimeGDB 插件已多年未更新，GDB 配置复杂；不如用 VS Code + C/C++ 扩展，它才是真正开箱即用的轻量替代
最常被忽略的点：Sublime 启动方式影响 PATH 继承。从桌面图标启动时，Windows 的 PATH 可能和 CMD 不一致；macOS 从 Spotlight 启动时，PATH 常丢失 Homebrew 路径——重启 Sublime 前，先关掉所有实例，再从终端用 subl 命令启动一次，才能确保环境干净。
