VSCode运行CMake项目必须依赖CMake Tools插件主导配置流程，启用cmake.configureOnOpen后执行CMake: Configure生成compile_commands.json，使C/C++插件自动切换至“cmake”IntelliSense模式；手动修改c_cpp_properties.json无效，头文件标红主因是编译器未被识别或未生成动态编译信息。
VSCode 能跑 CMake 项目，但默认不认 CMake —— 必须装对插件、配对编译器、让 CMake Tools 主导配置流程，否则 c_cpp_properties.json 手动改一百遍也没用。
为什么头文件标红、IntelliSense 找不到宏或第三方库
根本不是路径填错了，而是 VSCode 的 C/C++ 插件没拿到 CMake 实际生成的编译信息。它默认用“本地探测”模式，而 CMake 项目的真实包含目录、宏定义、标准版本全在构建过程中动态确定。
- 别手动写
c_cpp_properties.json里的includePath或defines—— 这些会被 CMake 的target_include_directories()和target_compile_definitions()覆盖 - 确保
CMake Tools插件已启用，并在设置中打开cmake.configureOnOpen（默认开启） - 让 CMake Tools 先完成一次
CMake: Configure，它会自动生成build/compile_commands.json，C/C++ 插件会自动识别并切换为 “cmake” IntelliSense 模式 - 如果仍标红，检查状态栏右下角是否显示类似
GCC 13.2.0 (MinGW)—— 不显示说明编译器路径根本没被 CMake Tools 读到
CMake: Configure 失败常见报错及对应动作
执行 CMake: Configure 后弹出错误，多数卡在工具链识别环节：
-
Unable to find any compilers：CMake 没在PATH里找到g++/clang++/cl.exe—— 不是 VSCode 的问题，是系统环境变量没生效（重启 VSCode 终端或整个编辑器） -
Generator is not available：比如选了MinGW Makefiles却没装 MinGW，或选了Ninja却没装ninja-build；Windows 用户推荐选MinGW Makefiles（配 MinGW-w64）或Visual Studio 17 2022（配 VS Build Tools） -
Could not find a package configuration file：CMakeLists.txt 里用了find_package(XXX)，但对应库没装或没加到CMAKE_PREFIX_PATH—— 先注释掉该行，确认基础configure能过
buildDirectory 和 sourceDirectory 怎么设才不踩坑
这两个配置直接决定 CMake 命令执行位置和缓存读写路径。设错会导致重复 configure、找不到 CMakeLists.txt、甚至污染源码目录。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
-
sourceDirectory必须指向含CMakeLists.txt的目录，比如${workspaceFolder}或${workspaceFolder}/src -
buildDirectory推荐用绝对路径变量，例如${workspaceFolder}/build/${buildType}-${platform}，避免多配置冲突 - Windows 上注意路径分隔符：VSCode 内部统一用
/，别写\，否则 CMake Tools 可能解析失败 - 如果项目有多个
CMakeLists.txt（如子模块），必须在设置里指定cmake.configureSettings中的CMAKE_SOURCE_DIR，否则插件会乱猜
交叉编译时，toolchain file 和 kit 到底谁管什么
kit 是 CMake Tools 里的“工具链抽象”，它描述“用哪套编译器+环境”，而 toolchain file 是 CMake 原生命令行参数 -DCMAKE_TOOLCHAIN_FILE=，用于交叉编译（如编译 ARM Linux 或 Android）。两者不等价，也不能互相替代。
- 常见混淆：以为选了个
ARM GCC 10.2.1的kit就能自动交叉编译 —— 实际上 kit 不提供CMAKE_SYSTEM_NAME或CMAKE_C_COMPILER的覆盖逻辑，必须显式传入toolchain file - toolchain file 必须在
cmake.configureSettings中设置："CMAKE_TOOLCHAIN_FILE": "/path/to/arm-linux-gnueabihf.cmake" - kit 只负责让 CMake Tools 知道该调用哪个
cmake命令和环境变量（如vcvarsall.bat），不干预 CMake 内部的平台判定
最易被忽略的是：删了 build/ 目录或改了 CMakeLists.txt 后，必须手动触发 CMake: Configure —— configureOnOpen 不会自动重跑，IntelliSense 和构建缓存也就不会更新。
