为何无法引入CMake导出/导入的仅头文件库的头文件？

我明白你现在遇到的困扰——按照《Effective CMake》的思路做仅头文件库，结果其他项目死活找不到头文件。结合你给出的项目结构，我来一步步帮你修正配置，让你的库能被正常导入使用。

先再明确下你的项目结构：

├── testinclude
│   ├── CMakeLists.txt
│   └── testinclude.cpp
└── testlib
    ├── CMakeLists.txt
    ├── include
    │   └── testLib.h
    └── testLibConfig.cmake

第一步：修正testlib/CMakeLists.txt #

仅头文件库在CMake里的核心是用INTERFACE类型库，它不会生成编译产物，只负责传递依赖信息（比如头文件路径）。替换你的testlib/CMakeLists.txt为以下内容：

cmake_minimum_required(VERSION 3.14) # 建议用3.14+的版本，支持更多现代特性
project(testLib VERSION 1.0.0 LANGUAGES CXX)

# 定义仅头文件的INTERFACE库
add_library(testLib INTERFACE)
add_library(testLib::testLib ALIAS testLib) # 加别名，符合现代CMake命名规范

# 设置头文件路径：BUILD_INTERFACE对应本地构建时的路径，INSTALL_INTERFACE对应安装后的路径
target_include_directories(testLib
    INTERFACE
        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
        $<INSTALL_INTERFACE:include>
)

# 安装头文件到指定目录
install(DIRECTORY include/ DESTINATION include)

# 导出目标，生成供其他项目导入的配置文件
install(TARGETS testLib
    EXPORT testLibTargets
    INCLUDES DESTINATION include
)

install(EXPORT testLibTargets
    FILE testLibTargets.cmake
    NAMESPACE testLib::
    DESTINATION lib/cmake/testLib
)

# 生成版本和配置文件，让find_package能识别版本
include(CMakePackageConfigHelpers)
write_basic_package_version_file(
    "${CMAKE_CURRENT_BINARY_DIR}/testLibConfigVersion.cmake"
    VERSION ${PROJECT_VERSION}
    COMPATIBILITY SameMajorVersion
)

# 用模板生成最终的Config.cmake
configure_package_config_file(
    "${CMAKE_CURRENT_SOURCE_DIR}/testLibConfig.cmake.in"
    "${CMAKE_CURRENT_BINARY_DIR}/testLibConfig.cmake"
    INSTALL_DESTINATION lib/cmake/testLib
)

# 安装生成的配置文件
install(FILES
    "${CMAKE_CURRENT_BINARY_DIR}/testLibConfig.cmake"
    "${CMAKE_CURRENT_BINARY_DIR}/testLibConfigVersion.cmake"
    DESTINATION lib/cmake/testLib
)

第二步：创建testLibConfig.cmake.in模板 #

上面的CMake配置用到了模板文件，你需要在testlib目录下新建testLibConfig.cmake.in，内容如下：

@PACKAGE_INIT@

include("${CMAKE_CURRENT_LIST_DIR}/testLibTargets.cmake")
check_required_components(testLib)

第三步：修改testinclude/CMakeLists.txt #

现在让测试项目能正确找到你的库，修改testinclude/CMakeLists.txt：

cmake_minimum_required(VERSION 3.14)
project(testinclude LANGUAGES CXX)

# 查找testLib，需要指定库的安装路径（或者提前设置CMAKE_PREFIX_PATH环境变量）
find_package(testLib REQUIRED)

add_executable(testinclude testinclude.cpp)

# 链接到testLib的INTERFACE库，这样会自动继承头文件路径
target_link_libraries(testinclude PRIVATE testLib::testLib)

第四步：构建并安装testLib #

在testlib目录下执行以下命令完成安装：

mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/your/install # 替换成你想安装的路径，比如~/testlib_install
make install

第五步：构建testinclude项目 #

在testinclude目录下执行：

mkdir build && cd build
cmake .. -DCMAKE_PREFIX_PATH=/path/to/your/install # 和上面的安装路径保持一致
make

现在你的testinclude.cpp里就能直接写#include <testLib.h>正常编译了。

关键注意点 #

• 仅头文件库必须用INTERFACE类型，它只传递依赖信息，不生成任何二进制文件
• BUILD_INTERFACE和INSTALL_INTERFACE分别处理本地开发和安装后的路径场景，避免路径错误
• 用ALIAS目标（testLib::testLib）是现代CMake的最佳实践，能避免命名冲突

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