Windows10下Qt Creator用vcpkg引入PODOFO库报错求助

问题背景 #

在Windows10的Qt Creator中尝试用vcpkg安装并引入PODOFO库，出现找不到PODOFO配置文件、Freetype依赖缺失、WrapVulkanHeaders缺失等报错。

报错原因与解决步骤 #

1. 找不到PODOFO配置文件的解决 #

报错信息：

C:\Users\white\OneDrive\Projekte\PDFMergerGitHub\PDFMerger\src\CMakeLists.txt:17: Fehler: Could not find a package configuration file provided by "podofo" with any
of the following names:

podofoConfig.cmake
podofo-config.cmake

Add the installation prefix of "podofo" to CMAKE_PREFIX_PATH or set
"podofo_DIR" to a directory containing one of the above files. If "podofo"
provides a separate development package or SDK, be sure it has been
installed.

解决方法：

• 不要手动在CMakeLists.txt中添加CMAKE_TOOLCHAIN_FILE和include语句，Qt Creator的vcpkg插件已负责处理工具链配置。
• 确认vcpkg插件激活后指定的vcpkg路径为完整安装路径（如C:/vcpkg）。
• 确保项目的vcpkg.json正确声明PODOFO依赖：

  {
    "dependencies": [
      "podofo"
    ]
  }
  

• 清理CMake缓存后重新运行配置。

2. 找不到Freetype依赖的解决 #

报错信息：

C:\Users\white\OneDrive\Projekte\PDFMergerGitHub\PDFMerger\src\CMakeLists.txt:22: Fehler: Could NOT find Freetype (missing: FREETYPE_LIBRARY FREETYPE_INCLUDE_DIRS)

Call-Stack:
C:/Users/white/OneDrive/Projekte/PDFMergerGitHub/PDFMerger/src/CMakeLists.txt:22 (find_package)
C:/vcpkg/scripts/buildsystems/vcpkg.cmake:859 (_find_package)
C:/vcpkg/installed/x64-windows/share/podofo/podofo-config.cmake:2 (find_dependency)
C:/Qt/Tools/CMake_64/share/cmake-3.27/Modules/CMakeFindDependencyMacro.cmake:76 (find_package)
C:/vcpkg/scripts/buildsystems/vcpkg.cmake:859 (_find_package)
C:/Qt/Tools/CMake_64/share/cmake-3.27/Modules/FindFreetype.cmake:162 (find_package_handle_standard_args)
C:/Qt/Tools/CMake_64/share/cmake-3.27/Modules/FindPackageHandleStandardArgs.cmake:600 (_FPHSA_FAILURE_MESSAGE)
C:/Qt/Tools/CMake_64/share/cmake-3.27/Modules/FindPackageHandleStandardArgs.cmake:230 (message)

解决方法：

• 打开命令行进入vcpkg目录，手动安装Freetype：

  .\vcpkg install freetype:x64-windows
  

• 在vcpkg.json中添加Freetype依赖声明：

  {
    "dependencies": [
      "podofo",
      "freetype"
    ]
  }
  

• 清理CMake缓存后重新配置项目。

3. 找不到WrapVulkanHeaders的解决 #

解决方法：

• 进入vcpkg目录安装对应依赖：

  .\vcpkg install vulkan-headers:x64-windows
  

• 若项目需要，在CMakeLists.txt中添加Vulkan查找配置：

  find_package(Vulkan REQUIRED)
  target_link_libraries(PDFMergerMSVC PRIVATE Vulkan::Vulkan)
  

• 清理CMake缓存后重新运行配置。

通用注意事项 #

• 确保vcpkg安装的包与Qt Creator使用的编译器架构一致（如均为x64-windows）。
• 每次修改vcpkg.json或安装新包后，必须清理CMake缓存再重新配置。
• 不要手动指定podofo_DIR或工具链文件，交由vcpkg插件自动处理路径。

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