必须装cmake tools插件，因其在configure时自动生成compile_commands.json，使c/c++插件切换至“cmake” intellisense模式；手动修改c_cpp_properties.json无效，因其中includepath和defines会被cmake动态配置覆盖。
为什么CMake Tools插件必须装，且不能只靠手动改c_cpp_properties.json
VSCode的C/C++插件默认用“本地探测”模式解析头文件和宏，而CMake项目的真实包含路径、标准版本、预定义宏全在configure阶段动态生成。手动往c_cpp_properties.json里填includePath或defines会被CMake实际配置覆盖，标红根本不会消失。
真正起作用的是compile_commands.json——它由CMake Tools在configure时自动生成，C/C++插件识别到它后自动切换为“cmake” IntelliSense模式。没这个文件，就等于没告诉编辑器“你正在处理一个CMake项目”。
- 确保已安装
CMake Tools（Kitware官方）和C/C++（Microsoft）两个插件 - 设置中开启
cmake.configureOnOpen（默认已开，但建议检查） - 首次打开项目后，状态栏右下角必须显示类似
GCC 13.2.0 (MinGW)——不显示说明编译器路径没被CMake Tools读到 - 如果没生成
build/compile_commands.json，CMake: Configure命令一定失败了，别跳过这步直接写代码
CMakeLists.txt里哪些行最容易导致configure失败
常见报错Could not find a package configuration file，本质是find_package()找不到库，不是路径写错了，而是环境或依赖缺失。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
find_package(OpenCV REQUIRED)：Windows需提前编译OpenCV（不能直接用VS版二进制），Linux用sudo apt install libopencv-dev即可 -
find_package(Torch REQUIRED)：libtorch需下载对应CPU/GPU版本，并把libtorch/share/cmake/Torch路径加到CMAKE_PREFIX_PATH环境变量 -
set(CMAKE_CXX_STANDARD 17)要放在project()之后，否则部分旧CMake版本会忽略 - Windows配MinGW时，
project()里别写CXX以外的语言，否则可能触发MSVC工具链误判
Windows下选哪个Generator？MinGW Makefiles还是Ninja
二者都能用，但错误类型和调试成本差异很大：
-
MinGW Makefiles：依赖mingw32-make.exe，需确认它在PATH里；报错信息直白（比如g++.exe: command not found），适合初学者定位编译器路径问题 -
Ninja：构建更快，但报错常卡在Unknown target或no rule to make target，实际可能是ninja.exe没装或build.ninja生成失败 - VSCode状态栏右下角显示
MinGW或Ninja即表示Generator生效；若显示Visual Studio，说明CMake Tools误读了系统里装的VS Build Tools - 切Generator后务必删掉整个
build/目录再重新Configure，残留文件会导致冲突
Linux/macOS下build/目录放哪？权限和路径有坑吗
Linux下build/通常建在项目根目录，但要注意两点：
- 不要放在
/tmp或挂载为noexec的分区里，否则configure会报Permission denied（即使有写权限） - 如果项目路径含中文或空格，CMake可能解析失败，尤其
find_package()调用外部库时；建议路径纯英文、无空格 -
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)必须加在CMakeLists.txt顶部附近，否则VSCode无法读取compile_commands.json - WSL2用户注意：Windows侧修改过的
CMakeLists.txt保存后，Linux侧可能因缓存延迟未生效，强制CMake: Clean再Configure
.cpp文件才发现头文件全标红，其实从第一次Configure失败就开始错了。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
