如何将CMake项目正常编译的头文件搜索路径传入CMAKE_REQUIRED_INCLUDES？

是否可行？ #

完全可行。CMAKE_REQUIRED_INCLUDES就是用来指定check_include_file_cxx这类检查工具编译测试代码时的头文件搜索路径，把项目正常编译时的所有包含目录传入，能让检查逻辑和实际编译环境完全对齐，从根本上避免假阴性问题。

具体操作方法 #

1. 提取单个目标的包含目录 #

用CMake的get_target_property命令可以直接获取目标通过target_include_directories设置的所有目录（覆盖PUBLIC/PRIVATE/INTERFACE三种类型）：

# 替换成你实际的目标名称
get_target_property(TARGET_INCLUDES my_target INCLUDE_DIRECTORIES)

2. 传递目录到检查工具 #

把获取到的目录列表赋值给CMAKE_REQUIRED_INCLUDES，之后调用check_include_file_cxx就会使用这些路径进行检查：

set(CMAKE_REQUIRED_INCLUDES ${TARGET_INCLUDES})

# 示例：检查单个头文件的自包含性
check_include_file_cxx("my_header.h" MY_HEADER_IS_SELF_CONTAINED)
if(MY_HEADER_IS_SELF_CONTAINED)
    message(STATUS "my_header.h 支持自包含")
else()
    message(WARNING "my_header.h 无法自包含")
endif()

3. 批量处理多个目标 #

如果项目有多个可执行或库目标，可遍历所有目标逐个处理：

# 获取项目中所有构建目标
get_property(ALL_TARGETS DIRECTORY PROPERTY BUILDSYSTEM_TARGETS)

foreach(TARGET IN LISTS ALL_TARGETS)
    get_target_property(TARGET_TYPE ${TARGET} TYPE)
    # 仅处理可执行文件和库目标，跳过自定义目标
    if(TARGET_TYPE STREQUAL "EXECUTABLE" OR TARGET_TYPE MATCHES "^LIBRARY$")
        get_target_property(TARGET_INCLUDES ${TARGET} INCLUDE_DIRECTORIES)
        if(TARGET_INCLUDES)
            set(CMAKE_REQUIRED_INCLUDES ${TARGET_INCLUDES})
            # 遍历目标下的所有头文件（路径可根据项目结构调整）
            file(GLOB TARGET_HEADERS "${CMAKE_CURRENT_SOURCE_DIR}/include/*.h" "${CMAKE_CURRENT_SOURCE_DIR}/src/*.h")
            foreach(HEADER IN LISTS TARGET_HEADERS)
                get_filename_component(HEADER_NAME ${HEADER} NAME)
                check_include_file_cxx("${HEADER_NAME}" HEADER_IS_SELF_CONTAINED)
                # 输出检查结果
                if(HEADER_IS_SELF_CONTAINED)
                    message(STATUS "[${TARGET}] ${HEADER_NAME} 自包含正常")
                else()
                    message(WARNING "[${TARGET}] ${HEADER_NAME} 无法自包含")
                endif()
            endforeach()
        endif()
    endif()
endforeach()

额外注意事项 #

• 必须在调用check_include_file_cxx之前设置CMAKE_REQUIRED_INCLUDES，否则设置不会生效。
• 如果目标包含系统头文件目录（通过SYSTEM关键字声明），INCLUDE_DIRECTORIES会自动包含这些路径，无需额外处理。
• 对于INTERFACE类型的目标，需要提取INTERFACE_INCLUDE_DIRECTORIES属性：

  get_target_property(TARGET_INTERFACE_INCLUDES my_interface_target INTERFACE_INCLUDE_DIRECTORIES)
  set(CMAKE_REQUIRED_INCLUDES ${TARGET_INTERFACE_INCLUDES})
  

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