cmakepresets.json是跨平台构建中枢，需置于项目根目录并显式指定binarydir、固定ninja生成器、用cachevariables设cmake_prefix_path；kit须按编译器组合分离且存于用户目录；compile_commands.json须由cmake生成并配置c_cpp.configurationprovider为cmake-tools。
configurePresets.json 是跨平台构建的中枢
VSCode 里点“Configure”按钮就失败，或者不同系统上构建行为不一致，大概率是因为还在靠手动传 -D 参数或改 settings.json。CMake 3.21+ 原生支持的 CMakePresets.json 才是解法——它把构建逻辑从编辑器配置里剥离出来，变成项目级声明式配置。
关键点：
-
CMakePresets.json必须放在项目根目录，VSCode 的 CMake Tools 插件会自动识别 - 每个
configurePreset要显式指定binaryDir，避免 Windows/macOS/Linux 下路径拼接出错（比如别用${sourceDir}\build，统一用${sourceDir}/build/${presetName}） - 跨平台时，
generator推荐固定为Ninja（比 Make 更一致，Windows 上也无需 MSVC 命令行环境） - 如果项目依赖第三方库（如
fmt或OpenCV），在cacheVariables里加CMAKE_PREFIX_PATH，而不是靠find_package()猜路径
Kit 配置必须和 preset 解耦
Kit 不是“选个编译器就完事”，它是 CMake Tools 用来定位工具链的元信息。很多人把 gcc-12 和 clang-15 都塞进一个 Kit，结果 configure 时 CMake 报 No CMAKE_CXX_COMPILER —— 因为 Kit 只能绑定一套 C/CXX 编译器路径。
正确做法：
- 每个 Kit 对应一个明确的编译器组合，例如：
"name": "GCC 12.2 (x86_64)"和"name": "Clang 15 (arm64)" - Kit 文件（
cmake-tools-kits.json）建议放在用户目录（~/.vscode/cmake-tools-kits.json），而非项目内，避免污染 - 在
CMakePresets.json的configurePreset中通过kit字段引用 Kit 名称，而不是靠状态栏手动切换 —— 这样才能保证 CI 和本地行为一致 - Windows 上若用 MSVC，Kit 名称里必须含
Visual Studio或MSVC，否则插件不会自动注入vcvarsall.bat环境
compile_commands.json 必须由 CMake 生成，不能手写
头文件跳转失效、#include 报红、IntelliSense 提示“未定义标识符”，90% 是因为 C/C++ 插件还在读过时的 c_cpp_properties.json。VSCode 的 C/C++ 插件默认不理解 CMake 的 target_include_directories() 或 find_package() 结果。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
强制让它对齐真实构建配置：
- 在
CMakeLists.txt开头（project()后）加set(CMAKE_EXPORT_COMPILE_COMMANDS ON) - 确保
CMakePresets.json中的configurePreset没禁用该选项（默认开启） - VSCode 设置中搜索
c_cpp.configurationProvider，值设为ms-vscode.cmake-tools（不是Default） - 首次配置后执行命令面板里的
C/C++: Reset IntelliSense Database，否则缓存不刷新
toolchain file 和 kit 不可混用
想交叉编译 ARM Linux 或裸机固件？别指望选个 “ARM GCC” Kit 就能自动生效。Kit 描述的是“本机上可用的编译器”，而 toolchain file 才是告诉 CMake “我要为另一个系统生成代码”。
典型错误场景：
- 在
CMakePresets.json里写了"kit": "ARM GCC 10.2"，但没配toolchainFile→ CMake 仍按 host 系统生成二进制 - 写了
toolchainFile却没在对应 Kit 中指定compilers→ configure 阶段找不到arm-none-eabi-gcc
正确组合：
- 先确保
arm-none-eabi-gcc在 PATH 中或 Kit 的compilers.CXX显式指向它 - 在
CMakePresets.json的configurePreset中加字段："toolchainFile": "${sourceDir}/cmake/arm-gcc-toolchain.cmake" - toolchain file 内必须包含
set(CMAKE_SYSTEM_NAME Generic)或set(CMAKE_SYSTEM_NAME Linux)，否则 CMake 不进入交叉编译模式
最易被忽略的一点：toolchain file 里的路径必须用正斜杠 /，即使在 Windows 上写 C:/sdk/arm-gcc/ 也会被 CMake Tools 解析失败 —— 统一写成 C:/sdk/arm-gcc/ 或更好是 ${sourceDir}/toolchains/arm-gcc.cmake。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
