配置Sublime Text支持CMake构建系统需创建.sublime-build文件，定义shell_cmd执行mkdir、cmake和make命令，设置working_dir为当前文件路径，通过variants提供构建、清理、重建选项，配合正确CMakeLists.txt实现跨平台编译，建议使用外部终端查看日志并避免路径含空格或中文。
Sublime Text 虽然是轻量级编辑器，但通过合理配置可以高效管理 C++ 项目，尤其是结合 CMake 构建系统后，能实现跨平台、模块化的编译流程。下面教你如何在 Sublime 中配置基于 CMake 的构建系统，提升开发效率。
1. 理解 Sublime 构建系统的机制
Sublime 的构建系统本质上是运行外部命令的封装。它通过 .sublime-build 文件定义执行的程序、参数、工作目录等。要支持 CMake，不能直接“编译单个文件”，而是需要先生成构建目录，再调用构建命令（如 make 或 ninja）。
关键点：
- 构建系统不等于编译器，它是“启动构建流程”的入口
- CMake 需要两步：cmake 生成构建文件 + 构建工具（如 make）执行编译
- 推荐使用外部终端或 Sublime 控制台查看完整输出
2. 创建 CMake 构建系统配置文件
打开 Sublime：菜单栏选择 Tools → Build System → New Build System…，替换默认内容为以下 JSON：
立即学习“C++免费学习笔记（深入）”；
{ "shell_cmd": "mkdir -p build && cd build && cmake .. && make", "working_dir": "$file_path", "selector": "source.c, source.cpp", "file_regex": "^(..[^:]):([0-9]+):([0-9]+): (.)$", "variants": [ { "name": "Build Only", "shell_cmd": "cd build && make" }, { "name": "Clean", "shell_cmd": "rm -rf build" }, { "name": "Rebuild", "shell_cmd": "rm -rf build && mkdir -p build && cd build && cmake .. && make" } ] }
说明：
- shell_cmd：默认构建行为，创建 build 目录，运行 cmake 和 make
- working_dir：设置工作目录为当前文件所在路径，确保 CMakeLists.txt 可被找到
- file_regex：解析错误信息中的文件、行、列，点击即可跳转
- variants：提供多个选项，可通过 Command+Shift+P → Build With… 切换
保存为：CMakeBuilder.sublime-build，名字可自定义。
3. 项目结构与 CMakeLists.txt 示例
确保你的项目根目录有正确的 CMakeLists.txt，例如：
CMakeLists.txt
cmake_minimum_required(VERSION 3.10) project(MyCppProject)
set(CMAKE_CXX_STANDARD 17)
add_executable(main main.cpp util.cpp include/util.h) target_include_directories(main PRIVATE include)
目录结构建议：
MyCppProject/
├── CMakeLists.txt
├── main.cpp
├── include/
│ └── util.h
└── src/
└── util.cpp
只要 CMakeLists.txt 正确，Sublime 构建系统就能驱动整个流程。
4. 使用技巧与常见问题
提升体验的小建议：
- Windows 用户可替换 shell_cmd 为 PowerShell 或使用 mingw32-make
- 想用 Ninja？修改命令为 cmake -G "Ninja" .. && ninja
- 开启 Sublime 控制台（Ctrl+`）查看详细构建日志
- 配合 C++ 智能补全插件（如 EasyClangComplete）获得更好编码体验
若构建失败，检查：
- 是否安装 cmake 和 make
- CMakeLists.txt 是否在 $file_path 目录下
- 路径中是否有空格或中文（尽量避免）
基本上就这些。配置一次，后续项目复制 .sublime-build 文件即可复用。不复杂但容易忽略细节。
