这种问题我在Stack Overflow上碰过太多次了——明明确认了目录已包含、文件也实实在在存在，编译就是报错，大概率是这些容易忽略的细节出了问题：

• 包含目录的时机或方式不对
  如果你是在add_executable定义测试目标之后，才用include_directories添加包含目录，CMake已经解析完目标的依赖配置了，后续的包含不会生效。更稳妥的是先设置包含目录再创建目标，或者用现代CMake推荐的target_include_directories（针对单个目标设置，避免全局污染）：

  # 传统写法：先设置全局包含目录，再创建目标
  include_directories(${PROJECT_SOURCE_DIR}/include)
  add_executable(my_test test.cpp)
  
  # 更推荐的现代写法：仅给测试目标添加私有包含目录
  add_executable(my_test test.cpp)
  target_include_directories(my_test PRIVATE ${PROJECT_SOURCE_DIR}/include)
  

• 路径变量拼写或混淆
  别把PROJECT_SOURCE_DIR和CMAKE_SOURCE_DIR搞混了：前者是当前project()命令所在目录的路径，后者是根CMakeLists.txt的所在目录。如果你的include目录在根目录下，但当前子目录的project()不在根目录，用PROJECT_SOURCE_DIR就会指向错误的路径。可以加一行打印命令验证实际路径：

  message(STATUS "实际包含目录: ${PROJECT_SOURCE_DIR}/include")
  

  运行CMake时看看输出的路径和你预期的是否一致。

• 代码中的头文件引用与CMake配置不匹配
  比如你在CMake里包含了${PROJECT_SOURCE_DIR}/include，但代码里写的是#include "subdir/header.h"，可实际上header.h直接放在include目录下；或者反过来，你包含的是include/subdir，代码里却写#include "header.h"。要确保代码中的include路径和CMake设置的包含目录层级完全对应。

• CMake缓存残留导致的旧配置干扰
  CMake会缓存之前的配置信息，有时候你修改了CMakeLists.txt，但旧的缓存还在生效。解决方法很简单：删除build目录下的CMakeCache.txt和CMakeFiles文件夹，然后重新运行cmake ..和编译命令，从头生成干净的配置。

• 测试目标缺失依赖库链接
  有时候报错看起来是头文件找不到，但实际是链接阶段的问题——比如你的测试代码依赖项目的核心库，但你只包含了头文件，没链接对应的库。这时候要给测试目标加上链接依赖：

  target_link_libraries(my_test PRIVATE my_core_library)
  

• 大小写敏感问题（Linux/macOS环境）
  如果你用的是类Unix系统，文件名是大小写敏感的。比如CMake里写的是Include目录，实际目录是include；或者代码里写#include "Header.h"，但实际文件是header.h，这都会导致文件找不到的错误。仔细核对所有路径和文件名的大小写是否完全一致。

内容的提问来源于stack exchange，提问作者Yuriy Rusinov