cmake中头文件找不到的根本原因是编译器未获知搜索路径，推荐用target_include_directories为具体目标设置private或public包含路径，全局可用include_directories但不传递至子目录，也可启用cmake_include_current_dir自动包含当前源码目录。
在CMake项目中，头文件找不到是编译失败最常见原因之一，比如#include "mylib.h"报错“no such file or directory”，根本原因不是文件不存在，而是CMake没告诉编译器去哪找它。
用 target_include_directories 为具体目标添加路径（推荐）
第一步：确认你的目标名。打开CMakeLists.txt，找到类似add_executable(myapp src/main.cpp)或add_library(mylib src/lib.cpp)的行，myapp或mylib就是目标名。
第二步：在add_executable或add_library之后、target_link_libraries之前，插入一行：target_include_directories(myapp PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include)。
第三步：如果头文件在project_root/include下，而CMakeLists.txt在项目根目录，则直接写${CMAKE_SOURCE_DIR}/include；若CMakeLists.txt在src/子目录下，且头文件在../include，就写${CMAKE_CURRENT_SOURCE_DIR}/../include。
第四步：作用域选PRIVATE表示只供该目标内部源码使用；若你写的库要被其他模块#include其头文件，必须改用PUBLIC，否则调用方会报错。
用 include_directories 全局添加路径（仅限简单项目）
方法一：在project()之后、任何add_*之前，写include_directories(include)。这会让所有后续定义的目标都自动搜索include/目录。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
方法二：用绝对路径避免相对路径歧义：include_directories(${PROJECT_SOURCE_DIR}/include)。这个写法比include_directories(include)更安全，因为不会因CMakeLists.txt位置变动而失效。
【注意】include_directories 的路径对整个 CMakeLists.txt 生效，但不会传递给子目录的 CMakeLists.txt —— 如果你用了 add_subdirectory()，子目录必须单独配置。
让当前源码目录自动加入搜索路径
在cmake_minimum_required()之后、project()之前，加一行：set(CMAKE_INCLUDE_CURRENT_DIR ON)。
这相当于为每个目标自动执行target_include_directories(... PRIVATE ${CMAKE_CURRENT_SOURCE_DIR})，适合源码和头文件混放的旧项目。
但启用后，如果某个.cpp文件#include "utils.h"，而utils.h就在同一目录下，就能直接包含，无需额外配置路径。
