通过VCPKG安装GitHub库失败，但CMake+VS构建正常

问题概述 #

使用VCPKG安装GitHub仓库taketwo/radical时，出现链接错误：

LINK : fatal error LNK1104: cannot open file 'src\grabbers\grabbers.lib'

grabbers.lib是仓库内部子项目生成的库文件，手动通过CMake生成Visual Studio项目构建时一切正常，VCPKG构建参数与手动构建一致。

解决思路与排查步骤 #

1. 排查VCPKG双模式构建的差异 #

VCPKG默认会同时构建Release和Debug两种模式，而手动构建可能仅完成了单模式编译：

• 查看VCPKG的构建日志，确认报错发生在Release还是Debug阶段；
• 单独测试单模式安装，比如执行Release模式：

  vcpkg install radical:x64-windows-release --overlay-ports=ports/radical
  

  或Debug模式：

  vcpkg install radical:x64-windows-debug --overlay-ports=ports/radical
  

  若单模式正常，说明另一模式下grabbers.lib未正确生成，需针对性检查该模式的CMake配置。

2. 修正库文件路径的硬编码问题 #

报错中的路径src\grabbers\grabbers.lib是源码目录的相对路径，但VCPKG构建时，产物会被放在buildtrees/radical下的对应架构/模式子目录（如x64-windows/debug）：

• 检查原项目的CMakeLists.txt，确认主项目是否通过target_link_libraries链接grabbers的CMake目标，而非直接硬编码lib文件路径；
• 若原项目存在路径硬编码，可在portfile.cmake的vcpkg_cmake_configure阶段添加参数统一库输出路径：

  vcpkg_cmake_configure(
    SOURCE_PATH "${SOURCE_PATH}"
    OPTIONS
      -DWITH_CERES=OFF
      -DCMAKE_LIBRARY_OUTPUT_DIRECTORY=${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-${BUILD_TYPE}/lib
      -DCMAKE_ARCHIVE_OUTPUT_DIRECTORY=${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-${BUILD_TYPE}/lib
  )
  

3. 确保grabbers子项目被正确安装 #

VCPKG的vcpkg_cmake_install会执行CMake的install目标，若grabbers.lib未被配置为安装到VCPKG的输出目录，主项目链接时会找不到文件：

• 检查原项目中grabbers子项目的CMake配置，是否添加了install(TARGETS grabbers ...)语句，将库文件安装到CMAKE_INSTALL_PREFIX对应的lib/debug或lib目录；
• 若原项目未配置安装规则，可在portfile.cmake中手动拷贝grabbers.lib到VCPKG的输出目录，比如在vcpkg_cmake_install之后添加：

  # 拷贝Debug版本
  file(COPY "${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-debug/src/grabbers/grabbers.lib" 
       DESTINATION "${CURRENT_PACKAGES_DIR}/debug/lib")
  # 拷贝Release版本
  file(COPY "${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-release/src/grabbers/grabbers.lib" 
       DESTINATION "${CURRENT_PACKAGES_DIR}/lib")
  

4. 对比VCPKG与手动构建的CMake变量 #

两种环境的CMake变量差异可能导致构建行为不同：

• 在portfile.cmake的vcpkg_cmake_configure中添加-DCMAKE_EXPORT_COMPILE_COMMANDS=ON，导出编译命令到compile_commands.json；
• 将该文件与手动构建生成的compile_commands.json对比，重点检查CMAKE_BUILD_TYPE、CMAKE_INSTALL_PREFIX、CMAKE_RUNTIME_OUTPUT_DIRECTORY等关键变量的差异，针对性调整portfile参数。

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