CMake中find_package找到PKG包却无法获取.lib文件路径求助

你的问题确实是自行构建PKG包时，CMake配置阶段缺失了库文件的导出定义，导致find_package能找到Config.cmake，但无法正确填充PKG_LIBRARIES变量。下面是具体的检查和修复步骤：

1. 确保构建库时正确安装并导出目标 #

在PKG包的CMakeLists.txt中，必须明确用install(TARGETS)指令安装库文件，并通过EXPORT参数标记要导出的目标（这是生成库路径关联信息的核心）：

# 假设你的库名为PKG，根据实际类型选择SHARED/STATIC
add_library(PKG STATIC src/pkg_core.cpp)

# 安装库文件到指定目录，同时导出目标到PKGTargets
install(TARGETS PKG
        EXPORT PKGTargets
        # 静态库/.lib文件对应ARCHIVE目录，动态库对应LIBRARY/RUNTIME
        ARCHIVE DESTINATION lib
        LIBRARY DESTINATION lib
        RUNTIME DESTINATION bin)

2. 生成并安装Config.cmake与Targets.cmake #

仅安装库还不够，需要让CMake生成能被find_package识别的配置文件：

• 首先创建一个PKGConfig.cmake.in模板文件，内容如下：

# 导入导出的目标文件
include("${CMAKE_CURRENT_LIST_DIR}/PKGTargets.cmake")

# 可选：手动定义PKG_LIBRARIES变量（兼容旧用法）
set(PKG_LIBRARIES PKG::PKG)

• 然后在PKG的CMakeLists.txt中添加以下代码，生成并安装配置文件：

# 安装导出的Targets文件
install(EXPORT PKGTargets
        FILE PKGTargets.cmake
        NAMESPACE PKG::
        DESTINATION lib/cmake/PKG)

# 用模板生成最终的PKGConfig.cmake
configure_package_config_file(
    ${CMAKE_CURRENT_SOURCE_DIR}/PKGConfig.cmake.in
    ${CMAKE_CURRENT_BINARY_DIR}/PKGConfig.cmake
    INSTALL_DESTINATION lib/cmake/PKG
)

# 安装生成好的Config文件
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/PKGConfig.cmake
        DESTINATION lib/cmake/PKG)

3. 正确获取库路径的两种方式 #

修复包配置后，有两种方法获取.lib文件路径：

• 方法一：使用PKG_LIBRARIES变量（需在Config.cmake中定义）

  find_package(PKG 1.0.0 EXACT)
  message(STATUS "Lib path: ${PKG_LIBRARIES}")
  

• 方法二：更推荐的导入目标方式（CMake 3.0+支持）
  直接通过导入的PKG::PKG目标获取链接文件路径，无需依赖PKG_LIBRARIES：

  find_package(PKG 1.0.0 EXACT)
  if(PKG_FOUND)
      message(STATUS "Lib path: $<TARGET_LINKER_FILE:PKG::PKG>")
  endif()
  

4. 验证安装路径 #

构建并安装PKG包时，确保指定了正确的CMAKE_INSTALL_PREFIX，比如：

cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/path/to/install
cmake --build build --target install

安装后检查/path/to/install/lib下是否存在你的.lib文件，/path/to/install/lib/cmake/PKG下是否有PKGConfig.cmake和PKGTargets.cmake文件。

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