CMake求助：INTERFACE_INCLUDE_DIRECTORIES被自动添加路径的原因排查

1. 打印属性+追踪配置过程 #

先在CMakeLists里添加代码，打印目标的INTERFACE_INCLUDE_DIRECTORIES属性，确认路径的具体内容：

get_target_property(INCLUDE_DIRS target INTERFACE_INCLUDE_DIRECTORIES)
message(STATUS "Target 'target' INTERFACE_INCLUDE_DIRS: ${INCLUDE_DIRS}")

如果要精准找到路径被添加的时机，用CMake的追踪参数重新运行配置，搜索关键内容：

cmake --trace-expand -S . -B build | grep -E "CMAKE_CURRENT_SOURCE_DIR|INTERFACE_INCLUDE_DIRECTORIES"

这条命令会输出所有涉及目标包含路径修改的指令，直接定位到添加路径的代码位置。

2. 检查全局/默认设置 #

• 排查是否用了include_directories()全局指令，这个指令会把指定路径自动加到所有后续目标的包含路径中，包括INTERFACE_INCLUDE_DIRECTORIES。
• 检查CMAKE_INCLUDE_CURRENT_DIR变量是否被设为ON，开启后CMake会自动将CMAKE_CURRENT_SOURCE_DIR和CMAKE_CURRENT_BINARY_DIR加入当前目录下所有目标的包含路径。
• 确认add_library的源文件是否没有明确指定PRIVATE/PUBLIC/INTERFACE，部分CMake版本对未指定范围的源文件，会默认将其所在目录加入公共包含路径。

3. 排查自定义宏/第三方依赖 #

• 项目中如果有封装的自定义函数（比如add_custom_library），检查其内部是否修改了目标的包含路径属性。
• 暂时注释掉find_package引入的第三方依赖，重新配置CMake，看路径是否还会被添加，逐步缩小排查范围。

4. 临时 workaround（不推荐长期使用） #

如果暂时找不到根源，可以在设置target_include_directories后，强制过滤掉不需要的路径并重新设置属性：

get_target_property(CURRENT_INCLUDES target INTERFACE_INCLUDE_DIRECTORIES)
list(FILTER CURRENT_INCLUDES EXCLUDE REGEX "^${CMAKE_CURRENT_SOURCE_DIR}$")
set_target_properties(target PROPERTIES
    INTERFACE_INCLUDE_DIRECTORIES "$<BUILD_INTERFACE:/some/absolute/directory>;$<INSTALL_INTERFACE:include>;${CURRENT_INCLUDES}"
)

5. 验证CMake版本兼容性 #

不同CMake版本对目标包含路径的默认处理逻辑可能有差异，尝试切换到项目推荐的CMake版本，看问题是否消失，辅助定位版本相关的默认行为。

内容的提问来源于stack exchange，提问作者René paul Debroize