include_directories() 全局污染路径，易引发头文件混乱；应改用 target_include_directories() 按 private/public/interface 精确控制作用域，避免依赖冲突。
include_directories() 会污染全局作用域
直接在 CMakeLists.txt 里写 include_directories(./include) 看似简单，但所有后续定义的 target（包括子目录里的）都会自动继承这个路径。一旦项目变大、模块增多，头文件搜索路径就容易混乱，编译时可能意外包含错误版本的头文件。
更稳妥的做法是只对特定 target 设置包含路径：
- 用
target_include_directories(<target_name> PRIVATE ./include)</target_name>—— 仅该 target 编译时可见，不传递给依赖它的其他 target - 用
target_include_directories(<target_name> PUBLIC ./include)</target_name>—— 该 target 自己用，且它被别的 target 链接时，对方也能用到这个路径（适合库的头文件目录） - 用
target_include_directories(<target_name> INTERFACE ./include)</target_name>—— 仅用于导出，自身不编译，只影响链接方（常见于 header-only 库）
路径写相对还是绝对？别硬编码绝对路径
CMake 中所有路径默认相对于当前 CMakeLists.txt 所在目录。比如你的头文件在项目根目录下的 inc/，而 CMakeLists.txt 在 src/ 下，那就写 ../inc，而不是 /home/user/project/inc。
常见误操作：
- 在
add_subdirectory()后的子CMakeLists.txt中，仍用./include指向父目录的头文件 —— 实际应写../include或用${CMAKE_CURRENT_SOURCE_DIR}/../include - 混用
INCLUDE_DIRECTORIES和target_include_directories导致路径重复或覆盖 - 路径末尾加不加
/没影响，但不要写成./include/+#include "header.h"这种组合——CMake 不处理斜杠拼接逻辑，它只是把路径丢给编译器
SYSTEM 和 NO_SYSTEM 的区别影响警告级别
如果你引入的是系统级第三方头文件（如 Boost、Eigen），想让编译器忽略它们里面的警告，可以加 SYSTEM 修饰：
target_include_directories(mylib PUBLIC SYSTEM ${Boost_INCLUDE_DIRS})
这样 GCC/Clang 就不会对这些路径下的头文件报 -Wall 相关警告。但普通项目头文件绝不要加 SYSTEM，否则你自己的头文件问题也会被静默掉。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
另外注意：SYSTEM 在 MSVC 上基本无效，属于 GCC/Clang 特性；如果跨平台项目里用了，建议包裹在 $<cxx></cxx> 条件表达式里，不过大多数情况直接不用更省事。
INTERFACE_INCLUDE_DIRECTORIES 是遗留写法
老教程里常看到 set_target_properties(mylib PROPERTIES INTERFACE_INCLUDE_DIRECTORIES "./include")，这确实能导出头文件路径，但它绕过了 CMake 的现代 target 属性管理机制，无法和 PUBLIC/PRIVATE 权限语义对齐，也不支持生成正确的 export config（比如 install(EXPORT) 时路径丢失）。
现在应该统一用：
target_include_directories(mylib INTERFACE ./include)
或者更推荐显式写出依赖关系：
target_include_directories(mylib PUBLIC $<include> $<build_interface:>)</build_interface:></include>
这样 install 和 build 两种场景的路径才不会串。
实际项目里最容易被忽略的，是子模块的 CMakeLists.txt 没有正确设置 target_include_directories，而是靠父级的 include_directories() 硬撑——一旦抽离复用，立刻编译失败。
