必须用target_include_directories为已定义目标配置头文件路径，优先使用绝对路径表达式，根据目标类型选择private/public/interface作用域，并对系统头目录加system标记。
在CMake项目中为可执行文件或库正确配置头文件搜索路径，避免编译时报错“fatal error: xxx.h: No such file or directory”，必须用target_include_directories为具体目标设置作用域明确的包含路径，不能依赖全局include_directories。
先创建目标，再配路径
target_include_directories只能作用于已定义的目标，所以第一步必须先调用add_executable或add_library声明目标。
例如：add_executable(myapp main.cpp) → 这一步必须在target_include_directories之前完成，否则CMake会报错“Target 'myapp' not found”。
【target必须已存在】 否则命令直接失败，且错误提示不直观，容易误判为路径写错。
三种作用域怎么选
PRIVATE、PUBLIC、INTERFACE不是语法糖，它们直接决定头文件路径是否随链接关系传递给其他目标。
方法一：可执行文件用PRIVATE
target_include_directories(myapp PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include)
——仅myapp自己能用该路径下的头文件，链接它的库不会继承此路径。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
方法二：静态/动态库用PUBLIC
add_library(mylib src/lib.cpp)
target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)
——mylib自身编译时使用该路径，同时任何链接mylib的目标（如myapp）也会自动获得这个路径。
方法三：纯头文件库用INTERFACE
add_library(utils INTERFACE)
target_include_directories(utils INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/utils)
——utils本身不编译源码，但所有链接它的目标都能用${CMAKE_CURRENT_SOURCE_DIR}/utils里的头文件。
路径写法避坑指南
第一步：优先用绝对路径表达式
推荐写法：${CMAKE_CURRENT_SOURCE_DIR}/include 或 ${CMAKE_BINARY_DIR}/generated
不推荐写法：include（相对路径）→ 构建目录切换后可能失效。
第二步：多路径可一次写全
target_include_directories(myapp PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include ${CMAKE_CURRENT_SOURCE_DIR}/third_party/rapidjson)
第三步：系统头目录加SYSTEM标记
target_include_directories(myapp SYSTEM ${CMAKE_CURRENT_SOURCE_DIR}/vendor/openssl/include)
——让编译器把该路径当作系统头处理，抑制-Wall下的冗余警告。
【BEFORE慎用】 默认追加到搜索列表末尾，只有当你需要覆盖上游传递的同名路径时才显式加BEFORE，多数项目不需要。
