sublime text跑大型c++项目必须用cmake tools插件，原生.sublime-build无法处理kit选择、多配置构建、qt头文件定位等复杂依赖；需以文件夹方式打开项目、确保cmake/qmake/编译器在终端可用、正确设置qt6_dir，并启用cmake_export_compile_commands生成compile_commands.json供clangd补全。
Sublime Text 跑大型 C++ 项目，别硬写 .sublime-build 文件——CMake Tools 插件是唯一靠谱路径，否则 configure 失败、target 找不到、Qt 找不见头文件这些坑你得一个一个踩。
为什么原生 Build System 在大型项目里必崩
手写 JSON 构建系统本质是把 cmake 和 cmake --build 当成两步命令串起来，但大型项目依赖 Kit 选择、缓存变量、多配置（Debug/Release）、install 规则、自定义 generator（Ninja/Visual Studio），这些全靠 CMake Tools 的状态机管理。你手动写 "cmd": ["cmake", "-B", "build", "-G", "Ninja"]，一旦换编译器或加 Qt，就得重配整个 JSON，且无法感知 CMAKE_CXX_COMPILER 是否真的被识别。
- configure 阶段失败时，原生构建只报 “command failed”，不告诉你缺
qmake还是find_package(Qt6)路径不对 - 没有 target 列表，
cmake --build build --target xxx得你手动敲，没法一键选 test 或 install - 无法自动 reload 变更后的
CMakeLists.txt，改完必须关掉再开文件夹
CMake Tools 插件必须满足的三个前提
插件本身不解决环境问题，它只是调度器。以下三点漏一个，configure 就卡在 “Confi”（截断状态）：
- 必须用 File → Open Folder… 打开整个项目根目录，不能只打开
CMakeLists.txt—— 否则插件根本不会激活 -
cmake、qmake（Qt 项目）、编译器（g++、cl.exe、clang++）三者都得能在终端直接运行；Windows 用户尤其注意 MinGW 的mingw32-make或 MSVC 的msbuild是否在 PATH 中 -
CMakeLists.txt里若用了find_package(Qt6 REQUIRED)，必须确保 Qt 安装路径已注册（如 Windows 上set Qt6_DIR=C:/Qt/6.7.2/mingw_64/lib/cmake/Qt6），否则 Kit 选对了也 configure 失败
configure 失败时最该查的三处日志
CMake Tools 不弹红框报错，错误全埋在输出面板里。按 Ctrl+Shift+P 输入 CMake: Show Output Panel，重点盯：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- “Unable to find qmake”：Qt 项目没把
qmake加进 PATH，或Qt6_DIR指向错误目录（应到lib/cmake/Qt6，不是bin/） - “Could not find compiler set in environment variable CXX”：Kit 里选的编译器路径和系统实际路径不一致，比如选了 “GCC 13” 但系统只有
g++-14，得去插件设置里手动填绝对路径 - “No CMAKE_CXX_COMPILER could be found”：常见于 WSL2 + Windows 版 Sublime，GUI 启动的 Sublime 根本看不到 WSL 的 PATH，必须用 Linux 版 Sublime 或改用远程开发模式
compile_commands.json 不生成，Clangd 补全就等于摆设
CMake Tools 默认不导出 compile_commands.json，而 Clangd 插件全靠它做语义分析。必须在项目根目录的 CMakeLists.txt 顶部加一行：
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
然后删掉 build/ 目录，重新 CMake: Configure —— 成功后检查 build/compile_commands.json 是否存在且非空。如果用 Ninja generator，这个文件一定有；如果用 Visual Studio generator，则不会生成，得换 -G "Ninja" 或手动加 -DCMAKE_EXPORT_COMPILE_COMMANDS=ON 参数。
这一步最容易被跳过：configure 成功了、build 成功了、run 也成功了，但 Ctrl+Click 跳不到定义、补全全是 std:: 一级，问题八成出在这儿。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
