Sublime Text需通过CMakeBuilder插件实现CMake一键构建，但须手动配置cmake路径、build目录、生成器及构建类型，并确保项目根目录含CMakeLists.txt；macOS/Windows/Linux需分别解决PATH环境变量问题。
Sublime Text 本身不内置 CMake 支持，必须通过插件 + 外部工具链配合才能实现「一键 configure & build」。CMakeBuilder 是目前最轻量、适配性最好的方案，但直接装上就用往往失败——核心问题在于它不自动识别系统 CMake 路径，也不处理构建目录隔离和多配置（Debug/Release）切换。
确认 CMake 可执行文件已正确安装并可被 Sublime 找到
CMakeBuilder 插件启动时会调用 cmake 命令，如果终端能运行但 Sublime 报 command not found: cmake，说明 Sublime 的环境变量 PATH 和终端不一致（尤其在 macOS GUI 启动时、或 Windows 没加进系统 PATH）。
- macOS：检查是否用
brew install cmake安装；若用 GUI 方式打开 Sublime，需从终端执行open -a "Sublime Text"启动，否则读不到 shell 的 PATH - Windows：确认
cmake --version在 CMD/PowerShell 中能输出版本；若不行，把 CMake 的bin目录（如C:\Program Files\CMake\bin）手动加进系统环境变量PATH - Linux：确保
/usr/bin/cmake或/usr/local/bin/cmake存在；若用 snap 安装的 cmake，可能因权限限制无法被 Sublime 调用，建议改用 apt 安装
安装并配置 CMakeBuilder 插件（含关键 settings 修改）
插件默认配置极简，但缺少对构建类型、生成器、构建目录等关键控制，必须手动编辑 CMakeBuilder.sublime-settings。
- 用
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux）打开命令面板，输入Package Control: Install Package→ 搜索并安装CMakeBuilder - 打开
Preferences → Package Settings → CMakeBuilder → Settings，在右侧用户设置中填入以下内容（按需调整）：
{
"cmake_command": "cmake",
"build_dir": "${project_path}/build",
"generator": "Unix Makefiles",
"build_type": "Debug",
"cmake_options": [
"-DCMAKE_BUILD_TYPE=Debug"
]
}
注意：generator 值需与系统匹配——Linux/macOS 一般用 Unix Makefiles，Windows 若装了 Visual Studio 应改为 Visual Studio 17 2022（版本号按实际调整），否则 configure 会失败。
项目根目录必须包含 CMakeLists.txt，且不能嵌套过深
CMakeBuilder 默认只扫描当前 Sublime 项目根目录（即 subl . 打开的文件夹）下的 CMakeLists.txt。如果 CMakeLists.txt 在子目录（如 src/CMakeLists.txt），插件会静默跳过，不报错也不生成构建文件。
- 推荐结构：项目根目录下直接放
CMakeLists.txt，并用add_subdirectory(src)管理源码子目录 - 若必须用子目录 CMakeLists.txt，可在用户 settings 中显式指定路径：
"source_dir": "${project_path}/src" - 避免在含空格或中文路径的目录中使用；CMakeBuilder 对路径转义支持弱，容易卡在 configure 阶段
编译失败常见原因与快速验证方法
点击 Tools → Build System → CMakeBuilder 后按 Cmd+B（macOS）或 Ctrl+B（Win/Linux），若无反应或弹出错误日志，优先查这三项：
- 构建目录（
build_dir）是否被 Git 忽略或设为只读？删除整个build文件夹再试一次 - 是否在未保存
CMakeLists.txt的情况下触发 build？CMakeBuilder 不自动保存，修改后务必先Cmd+S - 终端执行
cmake -G "Unix Makefiles" -B build -S .看是否成功；若终端也失败，说明是 CMakeLists.txt 语法或依赖问题，不是插件配置问题
真正麻烦的点在于：CMakeBuilder 不提供 build 过程中的实时输出流，错误信息只显示最后一屏。调试时建议先在终端手动跑一遍完整流程，确认 CMake 配置无误，再回到 Sublime 使用插件封装。
