CMake Tools 插件更适合大型项目，因其支持Kit切换、多配置构建、target依赖分析、install规则及find_package路径控制，提供可视化配置状态、实时提示和日志折叠，而手写.sublime-build无法处理这些复杂需求。
为什么 CMake Tools 插件比手写 .sublime-build 更适合大型项目
因为大型 C++ 项目必然涉及 Kit 切换、多配置（Debug/Release）、target 依赖分析、install 规则、Qt/Boost 等外部库的 find_package 路径控制——这些不是靠 cmd 数组拼接就能解决的。手写构建系统在 configure 阶段就容易卡死，比如 find_package(Qt6 REQUIRED) 找不到 qmake 或路径里有空格时，错误堆栈根本不会透出到 Sublime 构建面板，只显示“configure failed”。CMake Tools 提供了状态栏实时提示、Kit 选择界面、target 下拉菜单和日志折叠，相当于把 CMake CLI 的黑盒操作可视化了。
必须用 File → Open Folder… 打开整个项目根目录，不能只打开 CMakeLists.txt；否则插件无法扫描子目录下的 CMakeLists.txt，也识别不了 add_subdirectory() 结构。
- Kit 必须匹配你已安装的 Qt 版本和编译器，例如
Qt 6.7.2 (MinGW 11 64-bit)，不是随便选个 “GCC x.x” 就行 - 首次
CMake: Configure失败后，别急着重试——先看输出面板里有没有Could not find qmake或CMAKE_CXX_COMPILER is not a full path这类明确线索 - 如果项目用了
FetchContent_Declare或ExternalProject_Add，确保网络通畅且 CMake 版本 ≥ 3.14（旧版会静默失败）
configure 失败但错误信息不明确？重点查这三处
CMake Tools 的 configure 日志常被截断或折叠，真正关键的报错往往藏在中间某一行。不要只盯着最后一句 “Configuring incomplete”，而是翻到最上方找第一个 CMake Error 或 WARNING:。
find_package 类错误最典型：比如 find_package(fmt CONFIG REQUIRED) 报 Could not find a package configuration file，实际原因是 fmt 没装，或装在非标准路径（如 /opt/fmt/lib/cmake/fmt），而 CMake 默认只查 CMAKE_PREFIX_PATH 和 /usr/local。这时得在 CMake Tools 的 Kit 设置里手动加 CMAKE_PREFIX_PATH=/opt/fmt。
立即学习“C++免费学习笔记（深入）”；
- Windows 下路径含空格（如
C:Program FilesQt.7.2msvc2019_64）必须用双引号包裹，但 CMake Tools 的 Kit 编辑器不支持直接输引号——得改cmake-kits.json文件，在对应 Kit 的env字段里写："CMAKE_PREFIX_PATH": "C:\Program Files\Qt\6.7.2\msvc2019_64" - macOS 上 Homebrew 安装的 Qt 常位于
/opt/homebrew/opt/qt，需确认该路径下有lib/cmake/Qt6目录，否则find_package(Qt6)必然失败 - Linux 下若用
apt install qt6-base-dev，注意它不提供qmake，得额外装qt6-tools-dev-tools，否则 Kit 检测时会跳过这个 Qt 版本
如何让 compile_commands.json 生效并支持 clangd 补全
没有 compile_commands.json，clangd 就是瞎子——它没法知道头文件搜索路径、宏定义、C++ 标准版本。CMake Tools 默认会在 build/ 目录生成它，但 Sublime 的 clangd 插件默认不自动读取。你得手动告诉它位置。
在 Sublime 的 Clangd.sublime-settings 里，把 "compilationDatabaseCommand" 设为 ["cmake", "-S", ".", "-B", "build", "-DCMAKE_EXPORT_COMPILE_COMMANDS=ON"]，或者更简单：确保构建前已在终端跑过一次 cmake -S . -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON，然后在设置里指定 "compilationDatabaseDirectory" 为 "build"。
- 如果项目用了
add_compile_options(-isystem /path/to/headers)，clangd 可能仍找不到符号——因为-isystem不写进compile_commands.json；得改用target_include_directories(mytarget SYSTEM PRIVATE /path/to/headers) - Windows 下 MinGW 项目生成的
compile_commands.json里路径全是正斜杠（/c/Users/...），clangd 能认；但 MSVC 项目生成的是反斜杠（C:\Users\...），需在Clangd.sublime-settings中加"fallbackFlags": ["-std=c++17"]保底 - 别把
compile_commands.json提交到 Git——它体积大且易变；加进.gitignore，靠 CI 或本地 configure 步骤重建
Build System 变体里写 && 为什么有时不生效
因为 && 是 shell 解析符，不是 CMake 或 make 自带的。你在 cmd 数组里写 ["cmake --build build && ./build/myapp"]，Sublime 会把它当一个字符串传给操作系统执行，但 GUI 启动的 Sublime 默认没加载 shell 环境变量，&& 就成了字面量，导致命令直接失败。
正确做法是显式启用 shell：加 "shell": true，并确保数组里只有一个 cmd 元素。例如：
{
"cmd": ["cmake --build build --config Release && ./build/myapp"],
"shell": true,
"working_dir": "$project_path"
}
但要注意：Windows CMD 和 PowerShell 对 && 的处理不同。CMD 认，PowerShell 要用分号 ;；所以跨平台项目建议拆成两个变体，或统一用 CMake Tools 的 CMake: Build and Debug 命令替代。
- Linux/macOS 下可删
"shell": true，改用shell_cmd字段，避免数组解析歧义 - 如果 build 目录不在项目根下（如设为
build/release），./build/myapp里的路径必须同步更新，否则运行时报No such file or directory - GUI 环境下执行二进制文件时，当前工作目录（
working_dir）和可执行文件所在目录不一致会导致./myapp找不到动态库（如 Qt 的libQt6Widgets.so）——这时得在shell_cmd里提前cd build && LD_LIBRARY_PATH=./lib ./myapp
