使用CMake target_sources的FILE_SET未自动配置正确包含目录？

是的，你需要额外显式调用target_include_directories——这是CMake FILE_SET HEADERS功能的一个常见认知误区，它的核心作用并非自动处理包含目录传递，而是标准化头文件的组织与安装流程。

核心原因解析 #

• FILE_SET HEADERS的定位：它主要用于将头文件分组管理，方便后续通过install(TARGETS ... FILE_SET HEADERS)批量安装头文件，或者让IDE正确识别头文件归属目标，但不会自动为目标设置并传递包含路径。
• 依赖库找不到头文件的本质：你的sockets库没有将include目录以PUBLIC/INTERFACE的方式暴露给依赖目标，因此链接sockets的sender库无法自动继承该路径，编译时自然缺少-Iinclude参数。

正确的配置示例 #

以你的sockets库为例，正确的CMake配置应该同时包含FILE_SET HEADERS和target_include_directories：

add_library(sockets)

# 用FILE_SET HEADERS组织头文件（仅用于分组和安装）
target_sources(sockets
  PUBLIC
    FILE_SET HEADERS
    BASE_DIRS include
    FILES
      include/sockets/socket.hpp
      # 其他需要公开的头文件
  PRIVATE
    src/socket.cpp
    # 其他私有源文件
)

# 显式设置包含目录，传递给所有依赖目标
target_include_directories(sockets
  PUBLIC
    # 构建阶段使用当前源码目录下的include
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    # 安装阶段使用系统/指定的include目录（如果需要安装库）
    $<INSTALL_INTERFACE:include>
)

补充说明 #

CMake 3.25的FILE_SET文档描述确实容易让开发者误以为它会自动处理包含目录，但实际上两者是分工明确的：

• target_include_directories负责传递编译阶段的包含路径
• FILE_SET HEADERS负责头文件的组织与安装分发

配置完成后，sender库链接sockets时就会自动获得include目录的-I参数，代码中也能正常解析sockets/socket.hpp头文件。

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