Sublime Text 编译失败主因是环境配置错误而非软件问题：需确认g++已安装并加入PATH，构建系统优先用g++命令而非绝对路径，避免中文路径，Windows注意DLL依赖，macOS/Linux警惕图形界面下PATH未继承。
Sublime Text 本身不带编译器，报错几乎全是环境没配对或构建系统写错了——不是 Sublime 的问题，是 g++ 没装、没加到 PATH，或者 .sublime-build 文件里路径/参数写崩了。
确认 g++ 能在命令行直接运行
这是最常被跳过的一步。Sublime 构建系统本质就是调用终端命令，如果终端里输 g++ --version 都报 “command not found”，那 Sublime 必然失败。
- Windows：装 MinGW-w64（推荐 官方推荐版本），安装时勾选
x86_64+posix+seh，装完把mingw64in路径加进系统环境变量PATH - macOS：用
brew install gcc（装完是g++-14这类名字），再用ln -s /opt/homebrew/bin/g++-14 /opt/homebrew/bin/g++建软链，或直接改构建系统里用g++-14 - Linux：
sudo apt install g++（Ubuntu/Debian）或sudo dnf install gcc-c++（Fedora），一般自带g++命令
验证方式：关掉所有终端和 Sublime，新开一个终端，输入 g++ --version 和 which g++，必须有输出。
sublime-build 文件里别硬写绝对路径
很多人复制网上的构建配置，看到 "cmd": ["C:\MinGW\bin\g++.exe", ...] 就照填，结果换台电脑就炸——路径一错，Sublime 不报具体错误，只显示 “build failed”。
立即学习“C++免费学习笔记（深入）”；
- 优先用
g++而非完整路径，靠系统PATH解析（前提是上一步已验证成功） - 如果必须指定路径（比如多版本共存），Windows 下路径分隔符用正斜杠
/或双反斜杠\，别用单（JSON 里会当转义符处理） - macOS/Linux 注意权限：如果
g++在/usr/local/bin但 Sublime 是图形界面启动的，它可能读不到 shell 的PATH，这时得在构建系统里显式写全路径，或用exec插件加载 shell 环境
推荐最小可用构建配置（保存为 C++.sublime-build，放在 Packages/User/）：
{
"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",
"variants": [
{
"name": "Run",
"shell_cmd": "cd "${file_path}" && "${file_path}/${file_base_name}""
}
]
}
中文路径或文件名导致编译失败
Windows 下尤其明显：g++ 对 UTF-8 路径支持差，Sublime 传给它的 ${file} 如果含中文，g++ 直接解析失败，报一堆乱码错误或 “No such file or directory”。
- 开发时一律用英文目录+英文文件名，比如
D:/code/test.cpp，别用D:/我的代码/测试.cpp - 如果实在绕不开，可在构建系统里加
"encoding": "cp936"（仅 Windows），但不保证稳定；更稳妥的是换 VS Code 或 CLion，它们对中文路径处理更成熟 - macOS/Linux 一般无此问题，但文件名含空格仍要小心——
${file}已自动加引号，通常 OK
构建后程序闪退、没输出、或提示 “找不到 .dll”
这不是编译失败，而是运行阶段的问题，常见于 Windows + MinGW。
- “闪退”：程序运行完立即关闭，看不到输出。解决方法是在代码末尾加
std::cin.get();或用 Sublime 的Run变体（上面示例已含），它会在新终端里执行 - “找不到 libwinpthread-1.dll” 等：MinGW 动态库没被找到。把
mingw64/bin加进系统PATH（重启 Sublime），或编译时加静态链接参数：-static-libgcc -static-libstdc++ - 调试需求强的话，别卡在 Sublime：生成的可执行文件可直接在终端运行，用
gdb调；Sublime 适合轻量编译+快速验证逻辑
真正卡住人的，往往不是语法或配置项本身，而是 Sublime 启动时没继承你 shell 里设好的 PATH，尤其是 macOS/Linux 图形界面下。这点比写错 cmd 参数更难排查。
