如何创建支持COMPONENTS调用的CMake多组件库项目？

你当前使用的target_include_directories配置本身就是CMake官方推荐的标准写法，不属于临时修复方案，可正式用于生产环境。以下是更工程化的优化配置方案：

优化头文件布局（强烈推荐） #

首先调整头文件安装规则，避免不同组件的头文件出现重名冲突：

# 各组件CMakeLists.txt中头文件安装配置示例（以Core组件为例）
install(FILES core.h
        DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/ltk/Core)

调整后安装路径为/usr/include/ltk/Core/core.h，外部项目引用时统一写#include <ltk/Core/core.h>，从根源避免头文件命名冲突。

头文件包含目录的两种规范配置 #

方式1：组件级独立配置（兼容性最佳，优先推荐） #

在每个组件的CMakeLists.txt中分别配置构建和安装阶段的包含目录，完全适配多组件的独立引用场景：

target_include_directories(${component}
    PUBLIC
        # 项目构建阶段使用源码路径，无需安装即可测试
        $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/${component}/include>
        # 安装后自动导出顶层include路径，配合带前缀的头文件引用写法
        $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
)

该写法和你当前使用的逻辑一致，属于CMake多组件项目的标准配置，不存在“临时解决”的问题。

方式2：全局统一配置（适合小型项目） #

如果项目组件少、头文件规则简单，可以直接在ltkConfig.cmake.in中统一配置全局包含路径，不需要每个组件单独配置：

# 写入ltkConfig.cmake.in文件头部
set_and_check(ltk_INCLUDE_DIR "@PACKAGE_CMAKE_INSTALL_INCLUDEDIR@")
include_directories(${ltk_INCLUDE_DIR}/ltk)

该写法会给所有引入ltk包的目标全局添加包含路径，灵活性较差，不推荐中大型项目使用。

额外配置校验项 #

• 确保每个组件目标配置了EXPORT_NAME属性，和命名空间拼接后符合预期：

  set_target_properties(${component} PROPERTIES EXPORT_NAME ${component})
  

• 根目录的install(EXPORT)配置要关联所有组件的导出目标，确保ltkTargets.cmake能正确生成所有组件的导入目标：

  install(EXPORT ltkTargets
          FILE ltkTargets.cmake
          NAMESPACE ltk::
          DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/ltk)
  

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