根本原因是系统未安装mingw-w64或未将c:\mingw64\bin添加到path环境变量,导致sublime text无法调用g++;需验证cmd中g++ --version成功、重启sublime、配置正确c++.sublime-build文件并避免中文路径。

Sublime Text 编译 C++ 报错 g++.exe: command not found
根本原因是 Sublime 没找到 g++,不是配置文件写错了,而是系统压根没装 MinGW 或没加进 PATH。
先在命令行运行 g++ --version,如果报错,说明 MinGW 没装好或环境变量没生效。推荐用 MinGW-w64(别用老版 MinGW),安装时勾选 x86_64 架构和 posix 线程模型,安装路径别带中文和空格(比如 C:\mingw64)。
安装完后,把 C:\mingw64\bin 加进系统 PATH,然后重启 Sublime Text(不重启,它读不到新环境变量)。
- Windows 设置 PATH:系统属性 → 高级 → 环境变量 → 系统变量里找
Path→ 新建 → 粘贴C:\mingw64\bin - 验证方式:关掉所有终端,新开一个 cmd,输
g++ --version能显示版本号才算成功 - Sublime 不会自动继承你改完 PATH 后的环境,必须彻底关闭再重开(包括右下角托盘进程)
Sublime 的 C++ Build System 配置写在哪、怎么写
Build System 是 Sublime 用来调 g++ 的“指令模板”,不是写在项目里,而是存在 Sublime 的用户配置目录中,文件名必须是 .sublime-build。
立即学习“C++免费学习笔记(深入)”;
路径一般是:%APPDATA%\Sublime Text\Packages\User\(Windows),新建一个文件叫 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",
"variants": [
{
"name": "Run",
"shell_cmd": "cd \"${file_path}\" && \"${file_path}/${file_base_name}\""
}
]
}
-
"shell_cmd"里-std=c++17建议显式指定,避免默认用 C++98 导致现代语法报错 -
"file_regex"这行决定点击错误信息能否跳转到对应行,别删或写错,否则编译报错点不了 - 如果代码用了
#include <bits></bits>,得加-static-libgcc -static-libstdc++,不然运行时可能缺 DLL - 保存后,在 Sublime 顶部菜单选 Tools → Build System → C++,再按
Ctrl+B才会走这个配置
为什么 Ctrl+B 编译成功但 Ctrl+Shift+B 运行失败
因为 Sublime 默认不执行生成的可执行文件,Ctrl+Shift+B 调的是 Build with...,不是你定义的 Run 变体——除非你手动选了那个 Run 选项。
更直接的办法:在 Build System 文件里加一个 variants,如上例所示;然后用 Ctrl+Shift+P 打开命令面板,输入 Build With: Run 回车,就能运行。
- 别指望
Ctrl+Shift+B自动识别 “Run”,它只认当前 Build System 的默认命令(即shell_cmd那行) - 如果运行时报
The system cannot find the file specified,大概率是g++编译出错但没报错(比如语法错却没停),导致没生成.exe,先确保Ctrl+B输出里没有 warning 或 error - 输出窗口里看到
[Finished in X.YZs]不代表成功,要看上面有没有error:或warning:行
中文路径或文件名导致编译失败
MinGW 的 g++ 在 Windows 下对 UTF-8 路径支持很弱,${file} 如果含中文,g++ 会直接报 No such file or directory,哪怕文件真实存在。
最稳的解法:开发时把源码全放在纯英文路径下,比如 D:\cpp\hello.cpp。实在绕不开中文路径,就别依赖 ${file},改用固定路径 + 手动编译,或者换 VS Code / CLion。
- Sublime 的
${file}是原样传给 shell 的,不会自动编码转换 - 即使你把文件另存为 UTF-8 with BOM,
g++也读不懂 - 这不是 Sublime 的 bug,是 MinGW 工具链本身的限制,别花时间折腾 locale 或 codepage
.sublime-build 有用得多。










