CMake报错：已引用导入目标但缺失——跨项目依赖liba问题

遇到这个报错太常见了，本质是你在安装liba时，CMake只导出了liba自身的目标信息，但没把它依赖的libb的导出配置一并提供给下游项目。同一个仓库里构建时没问题是因为CMake能直接找到libb，但安装后下游项目找不到libb的CMake配置文件，自然就报找不到导入目标的错了。

我给你一步步拆解解决方案：

1. 给每个库添加完整的CMake导出配置 #

首先要让libb和liba都能被下游项目通过find_package找到，这需要生成并安装对应的CMake配置文件。

修改libb/CMakeLists.txt #

在文件末尾添加以下内容，负责安装头文件、库文件，生成并导出CMake配置：

# 安装libb的公开头文件
install(
    FILES other.hh
    DESTINATION include/libb
)

# 安装库文件，同时导出目标信息
install(
    TARGETS libb
    EXPORT libbTargets
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
    RUNTIME DESTINATION bin
    INCLUDES DESTINATION include/libb
)

# 生成并安装Targets文件（供find_package识别）
install(EXPORT libbTargets
    FILE libbTargets.cmake
    NAMESPACE libb::
    DESTINATION lib/cmake/libb
)

# 生成版本配置文件
include(CMakePackageConfigHelpers)
write_basic_package_version_file(
    "${CMAKE_CURRENT_BINARY_DIR}/libbConfigVersion.cmake"
    VERSION ${PROJECT_VERSION}
    COMPATIBILITY SameMajorVersion
)

# 生成主配置文件（需要配合Config.cmake.in模板）
configure_package_config_file(
    "${CMAKE_CURRENT_SOURCE_DIR}/Config.cmake.in"
    "${CMAKE_CURRENT_BINARY_DIR}/libbConfig.cmake"
    INSTALL_DESTINATION lib/cmake/libb
)

# 安装Config和Version配置文件
install(
    FILES
    "${CMAKE_CURRENT_BINARY_DIR}/libbConfig.cmake"
    "${CMAKE_CURRENT_BINARY_DIR}/libbConfigVersion.cmake"
    DESTINATION lib/cmake/libb
)

然后在libb目录下创建Config.cmake.in模板文件，内容如下：

@PACKAGE_INIT@

include("${CMAKE_CURRENT_LIST_DIR}/libbTargets.cmake")
check_required_components(libb)

修改liba/CMakeLists.txt #

同样给liba添加导出配置，关键要声明对libb的依赖，这样下游项目导入liba时会自动查找libb：

# 重点：用别名目标链接libb，确保依赖关系能被正确导出
target_link_libraries(liba PUBLIC libb::libb)

# 安装liba的公开头文件
install(
    FILES module.hh
    DESTINATION include/liba
)

# 安装库文件并导出目标
install(
    TARGETS liba
    EXPORT libaTargets
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
    RUNTIME DESTINATION bin
    INCLUDES DESTINATION include/liba
)

# 生成并安装Targets文件
install(EXPORT libaTargets
    FILE libaTargets.cmake
    NAMESPACE liba::
    DESTINATION lib/cmake/liba
)

# 生成版本配置文件
include(CMakePackageConfigHelpers)
write_basic_package_version_file(
    "${CMAKE_CURRENT_BINARY_DIR}/libaConfigVersion.cmake"
    VERSION ${PROJECT_VERSION}
    COMPATIBILITY SameMajorVersion
)

# 生成主配置文件
configure_package_config_file(
    "${CMAKE_CURRENT_SOURCE_DIR}/Config.cmake.in"
    "${CMAKE_CURRENT_BINARY_DIR}/libaConfig.cmake"
    INSTALL_DESTINATION lib/cmake/liba
    NO_CHECK_REQUIRED_COMPONENTS_MACRO
)

# 安装Config和Version配置文件
install(
    FILES
    "${CMAKE_CURRENT_BINARY_DIR}/libaConfig.cmake"
    "${CMAKE_CURRENT_BINARY_DIR}/libaConfigVersion.cmake"
    DESTINATION lib/cmake/liba
)

对应的liba/Config.cmake.in模板要加上对libb的查找：

@PACKAGE_INIT@

# 自动查找依赖的libb
find_package(libb REQUIRED)

include("${CMAKE_CURRENT_LIST_DIR}/libaTargets.cmake")
check_required_components(liba)

2. 调整根目录CMakeLists.txt #

确保根目录设置好项目版本，并正确包含子目录：

cmake_minimum_required(VERSION 3.14)
project(MyLibraries VERSION 1.0.0)

add_subdirectory(libb)
add_subdirectory(liba)

3. 下游项目的正确使用方式 #

当下游项目依赖liba时，只需要在CMake中写：

find_package(liba REQUIRED)

target_link_libraries(YourProject PRIVATE liba::liba)

CMake会自动找到liba，并通过liba的配置文件自动拉取libb的依赖，不会再出现导入目标缺失的问题。

额外注意事项 #

• 如果自定义了安装路径（不是默认的/usr/local），下游项目需要通过CMAKE_PREFIX_PATH指定你的安装目录，比如：

  cmake -S . -B build -DCMAKE_PREFIX_PATH=/path/to/your/install/dir
  

• 如果liba只是内部使用libb（头文件不引用libb的内容），可以把target_link_libraries的PUBLIC改成PRIVATE，这时候下游项目不需要感知libb；但如果liba的头文件用到了libb，必须用PUBLIC，否则下游项目会找不到libb的头文件。

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