根本原因是VSCode未使用CMake构建系统，而是自行执行无-I参数的g++命令；解法是安装CMake Tools扩展、在项目根目录运行CMake: Configure并删除手动tasks.json任务。
VSCode 里 F5 调试报 fatal error: Gun.h: No such file or directory 怎么办
不是 CMake 配置错了，而是 VSCode 没用 CMake 生成的编译命令，它自己硬起一个 g++ main.cpp -o output/main 命令去编译 —— 完全没带 -I 头文件路径，自然找不到 Gun.h。
根本解法是让 VSCode 使用 CMake 构建系统，而不是手写任务：
- 确保已安装 CMake Tools 扩展（不是只装 CMake）
- 打开项目根目录（含
CMakeLists.txt的那个目录），不要在build/里打开 - 按
Ctrl+Shift+P→ 输入CMake: Configure，选对 kit（比如GCC 11.4.0） - 确认状态栏显示
Ready和构建类型（如Debug），再按F5 - 如果仍失败，检查
.vscode/tasks.json是否存在手动写的g++任务 —— 直接删掉它
include_directories() 写对了却还是找不到头文件
include_directories() 是全局作用域指令，但它只影响后续定义的目标（add_executable 或 add_library），不回溯已定义的目标。
常见错误写法：
add_executable(my_cmake_exe main.cpp src/Gun.cpp src/Soldier.cpp)
include_directories(${CMAKE_SOURCE_DIR}/include)
上面这行 include_directories 在 add_executable 之后，完全无效。
正确顺序必须是：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 先写
include_directories(${CMAKE_SOURCE_DIR}/include) - 再写
add_executable(...) - 或者更推荐：改用
target_include_directories(my_cmake_exe PRIVATE ${CMAKE_SOURCE_DIR}/include)，作用范围明确、可读性强、且支持 PRIVATE/PUBLIC/INTERFACE 语义
用 find_package() 却提示头文件或库找不到
根本原因通常是 CMake 没搜到对应库的 *Config.cmake 或 Find*.cmake 文件，尤其在 Anaconda、apt、源码混装环境下。
快速验证和修复方式：
- 运行
dpkg-query -L libgoogle-glog-dev | grep glog（Ubuntu/Debian）或brew --prefix glog（macOS），拿到真实头文件路径 - 临时指定搜索路径：
cmake -DCMAKE_PREFIX_PATH="/usr/include/glog:/usr/lib/x86_64-linux-gnu" .. - 或在
CMakeLists.txt开头加：set(CMAKE_PREFIX_PATH "/usr/include/glog" ${CMAKE_PREFIX_PATH}) - 避免直接用
set(GLOG_INCLUDE_DIRS ...)硬编码 —— 这会绕过find_package的依赖管理逻辑，后续链接可能出错
Qt 提升控件后报“找不到自定义头文件”
Qt Designer 生成的 ui_*.h 里会 #include 你的类头文件，但 moc 或 uic 生成代码时默认只查 build 目录和 Qt 自带路径，不自动包含你项目的 include/。
必须显式告诉 CMake：“这个可执行目标需要这些头文件路径”：
- 在
add_executable之后，立即加：target_include_directories(your_target_name PRIVATE ${CMAKE_SOURCE_DIR}/include) - 如果头文件在子目录（如
${CMAKE_SOURCE_DIR}/src/common），路径要写全，不能只写src - Qt6 + CMake 项目中，
qt_add_executable已内置部分路径处理，但自定义提升类仍需手动补target_include_directories
最易忽略的一点：改完 CMakeLists.txt 后，VSCode 或 Qt Creator 不会自动重载配置 —— 必须手动触发 CMake: Configure 或点击 “Reload CMake Project”，否则所有改动都不生效。
