Sublime Text 一键运行成败取决于系统编译器/解释器是否能在终端直接调用，需先验证g++或python命令是否有效，再配置正确的.sublime-build文件并注意平台差异与编码问题。
Sublime Text 本身不运行代码，它靠 Build System 调用系统里的编译器或解释器——所以“一键运行”成败的关键，不是装没装 Sublime，而是 g++ 或 python 是否在终端里能直接调用，且路径、编码、工作目录都对。
确认终端能调用编译器/解释器
这是最常被跳过的一步，但所有后续配置都依赖它。打开系统终端（cmd / PowerShell / 终端），输入：
g++ --version
或
python --version
如果报错 'g++' is not recognized 或 command not found，说明环境变量没配好，Build System 写得再漂亮也没用。
- Windows 下确认
MingW64\mingw64\bin已加进Path环境变量，且重启了终端（不是仅重启 Sublime） - macOS / Linux 用户检查
which g++或which python3输出是否有效路径；若用 pyenv 或 conda，建议在.sublime-build中写绝对路径，比如/opt/homebrew/bin/python3 - UOS 等国产系统若从应用商店安装 Sublime，默认不带开发工具链，需额外安装
build-essential或对应开发包
创建正确的 .sublime-build 文件
Build System 是 JSON 格式文件，存放在 Packages/User/ 目录下（可通过 Sublime 的 Preferences → Browse Packages 打开）。不要复制网上过时的 "cmd" 写法，Sublime Text 4 默认推荐用 "shell_cmd"。
例如 C++17 编译+运行（含中文支持）：
{
"shell_cmd": "chcp 65001 >nul && g++ \"$file\" -o \"$file_base_name.exe\" -std=c++17 -O2 -Wall && \"$file_base_name.exe\"",
"selector": "source.c++",
"encoding": "utf-8",
"variants": [
{
"name": "Run",
"shell_cmd": "chcp 65001 >nul && g++ \"$file\" -o \"$file_base_name.exe\" -std=c++17 -O2 -Wall && \"$file_base_name.exe\""
}
]
}
关键点：
-
chcp 65001是 Windows 下解决中文输出乱码的必要操作，Linux/macOS 不需要 -
$file_base_name.exe在 macOS/Linux 上应改为$file_base_name（无 .exe 后缀） -
-std=c++17可按需换成c++20或c++11，但必须与你安装的 GCC 版本兼容 - Python 用户别漏掉
-u参数："shell_cmd": "python -u \"$file\""，否则 print() 可能缓冲不输出
绑定快捷键前先验证 Build System 是否生效
别急着改 Key Bindings。先手动测试：写个 hello.cpp，保存后按 Ctrl+Shift+B，弹出菜单里选你刚保存的构建系统（如 C++17），看底部面板是否出现编译和运行结果。
- 如果报错
Unable to find target，说明文件没保存（$file为空）或后缀名不匹配selector（比如写了.cc却用source.c++） - 如果编译成功但运行一闪而退，是 Windows 控制台默认行为，可在
variants里加pause，或改用Terminus插件接管终端 - F5 绑定到
"variant": "Run"时，务必确认该 variant 名字和 JSON 里完全一致（大小写、空格都不能错）
中文输入/输出乱码的根本原因和解法
不是 Sublime 编码设成 UTF-8 就万事大吉。Windows 控制台默认是 GBK，g++ 编译 UTF-8 源码没问题，但 cout 会显示乱码——因为运行时控制台没切编码。
- 最稳方案：在
shell_cmd开头强制执行chcp 65001（UTF-8 代码页），并确保源文件保存为 UTF-8 无 BOM - 别信“改 Sublime 设置 encoding 就行”，那是编辑器读文件用的，不影响运行时终端编码
- Linux/macOS 用户遇到中文乱码，大概率是 locale 没设对，运行
locale看是否含UTF-8，不是就执行export LANG=en_US.UTF-8（加到 shell 配置文件里）
真正卡住人的地方，从来不是 JSON 语法或快捷键绑定，而是环境变量、终端编码、文件后缀这三者之间的隐性耦合。调不通时，先在终端里手动跑一遍 g++ hello.cpp -o hello && ./hello，再把每一步挪进 shell_cmd，比反复修改 Sublime 配置高效得多。
