Sublime Text需手动配置构建系统并安装GCC/Clang等编译器才能运行C/C++代码；macOS用xcode-select安装命令行工具，Windows推荐MinGW-w64并配置PATH，Linux安装build-essential或gcc-c++；建议自定义C++.sublime-build文件，多文件项目应使用Makefile。
Sublime Text 本身不带编译器，不能直接运行 C/C++ 代码；它只是个编辑器，必须手动配置构建系统（Build System）并确保系统已安装 GCC/Clang 等工具链。
确认系统已安装可用的 C/C++ 编译器
Sublime 的构建系统本质是调用命令行工具，如果 g++ 或 clang++ 命令在终端里都报 command not found，那任何 Sublime 配置都无效。
- macOS：运行
xcode-select --install安装命令行工具，或从 App Store 安装 Xcode 后执行xcode-select --switch /Applications/Xcode.app - Windows：推荐安装
MinGW-w64（非旧版 MinGW），并把bin/目录加进系统PATH；验证方式是在 CMD 中输入g++ --version - Linux：多数发行版默认带
build-essential（Ubuntu/Debian）或gcc-c++（CentOS/RHEL），用sudo apt install build-essential或对应命令补全
创建自定义 Build System（.sublime-build 文件）
Sublime 默认的 C++ Single File 构建系统只适用于单文件、无依赖的场景，且 Windows 下常因路径空格或编码问题失败。建议手写一个可控的构建系统。
操作路径：Tools → Build System → New Build System…，粘贴以下内容后保存为 C++.sublime-build：
立即学习“C++免费学习笔记（深入）”；
{
"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++11或c++20；-Wall开启常用警告，建议保留 - Windows 用户注意：
&&是 CMD 的命令分隔符，PowerShell 不兼容；如用 PowerShell，需改用;并调整引号逻辑 -
file_regex决定点击错误行能否跳转到对应位置，正则必须匹配编译器实际输出格式；GCC 输出形如main.cpp:5:10: error: …，所以上面正则才这么写
处理多文件项目或头文件依赖
Sublime 的构建系统天然不支持自动依赖分析和增量编译。一旦涉及多个 .cpp 文件或自定义 .h，就别硬扛——要么用 Makefile，要么换工具。
- 最轻量方案：在项目根目录写一个
Makefile，然后构建系统改成"shell_cmd": "make"，配合"working_dir": "${project_path}" - 避免用
g++ *.cpp：源文件顺序错乱会导致链接失败，尤其有模板或静态成员时 - 不要指望 Sublime 自动识别
#include "xxx.h"路径；若头文件不在当前目录，必须显式加-I/path/to/include
常见错误现象与对应检查点
按下 Ctrl+B（macOS Cmd+B）没反应、报错或输出乱码？先看这几处：
- 构建系统未激活：右下角状态栏应显示你刚保存的
C++，不是Automatic或None - 文件未保存就构建：Sublime 构建的是磁盘上已保存的文件，临时缓冲区内容不会参与编译
- 中文路径或文件名：GCC 在 Windows 下对 UTF-8 路径支持差，报错类似
fatal error: No such file or directory，请改用英文路径 - 终端编码问题（Windows）：CMD 默认 GBK，而 Sublime 输出 UTF-8，导致中文错误信息显示为乱码；可在构建系统中加
"encoding": "utf-8"，但更稳妥是换用Terminus插件替代原生输出面板
真正卡住的地方往往不是 Sublime 配置本身，而是编译器是否真能被调用、路径是否干净、错误信息是否可读——这些比选哪个插件或主题重要得多。
