排查CMake将目标A根目录添加为VS项目包含目录的原因

以下是针对该问题的具体排查步骤：

1. 检查目标A的本地CMake配置 #

• 打开A/CMakeLists.txt，搜索是否存在直接添加当前目录到包含路径的语句：
  • 查找include_directories(.)这类全局包含目录设置
  • 查找target_include_directories(A PRIVATE/PUBLIC/INTERFACE .)这类目标专属的包含目录配置
• 确认是否有通过file(GLOB_RECURSE ...)或其他批量处理命令间接引入了包含目录的变更

2. 检查父目录与目标依赖关系 #

• 查看根目录CMakeLists.txt，确认是否存在全局include_directories(A)或类似语句，将A目录加入所有目标的包含路径
• 检查其他依赖A的目标（如目标B）的配置：如果目标A通过target_include_directories使用了PUBLIC或INTERFACE关键字暴露自身目录，依赖它的目标会自动继承该包含路径

3. 验证CMake默认行为相关变量 #

• 检查是否设置了CMAKE_INCLUDE_CURRENT_DIR变量：该变量设为ON时，CMake会自动将当前CMakeLists.txt所在目录加入对应目标的包含路径，Windows下部分模板可能默认开启此设置
• 检查CMAKE_INCLUDE_CURRENT_DIR_IN_INTERFACE变量：若开启，当前目录会被添加到目标的INTERFACE_INCLUDE_DIRECTORIES，导致依赖目标也继承该路径

4. 使用CMake诊断工具追踪来源 #

• 针对目标A，在其CMakeLists.txt中添加诊断代码，打印自身包含目录：

  get_target_property(A_INCLUDES A INCLUDE_DIRECTORIES)
  message(STATUS "Target A include directories: ${A_INCLUDES}")
  

• 启用CMake的追踪模式重新生成项目，定位触发包含目录添加的代码：
  在命令行执行：

  cmake --trace-expand -S . -B <build-dir>
  

  搜索输出中与A目录相关的include_directories或target_include_directories调用，找到具体的代码行

5. 检查工具链与第三方模块 #

• 确认项目是否使用了Windows专属的工具链文件，检查其中是否有自动添加源文件目录到包含路径的逻辑
• 排查项目中引入的第三方CMake模块，看是否存在修改包含目录的通用逻辑

6. 跨平台对比缓存变量 #

• 在Windows和Linux的构建目录下分别执行cmake -L，列出所有缓存变量
• 对比与包含目录相关的变量（如CMAKE_INCLUDE_CURRENT_DIR、CMAKE_CXX_FLAGS等），确认Windows下是否存在特殊配置导致差异

内容的提问来源于stack exchange，提问作者αλεχολυτ