使用CMake与vcpkg时，如何链接Qt的调试版本？

问题根源 #

vcpkg作为包管理器时，仅设置CMAKE_BUILD_TYPE=Debug不足以强制链接Qt调试版本——vcpkg依赖**triplet（三元组）**区分编译配置，默认triplet会拉取发行版库，需显式指定debug类型的triplet才能让vcpkg提供Qt调试库。

解决步骤 #

• 清理旧构建缓存
  删除已有的构建目录，避免残留的发行版配置干扰：

  rm -rf build_debug
  

• 指定vcpkg Debug Triplet
  在CMake配置命令中添加debug相关参数（以x86_64 Linux为例）：

  cmake -B build_debug -S . \
    -DPDF4QT_INSTALL_QT_DEPENDENCIES=0 \
    -DCMAKE_TOOLCHAIN_FILE=$VCPKG_PATH/scripts/buildsystems/vcpkg.cmake \
    -DCMAKE_INSTALL_PREFIX='/' \
    -DCMAKE_BUILD_TYPE=Debug \
    -DVCPKG_TARGET_TRIPLET=x64-linux-debug \
    -DVCPKG_BUILD_TYPE=debug
  

  参数说明：

  • VCPKG_TARGET_TRIPLET=x64-linux-debug：指定vcpkg使用x86_64架构的debug配置包
  • VCPKG_BUILD_TYPE=debug：强制vcpkg仅编译、使用debug版本的依赖

• 确保vcpkg已安装Qt调试版本
  如果之前未安装过Qt的debug包，先手动安装对应模块（以Qt6核心组件为例）：

  vcpkg install qt6-widgets:x64-linux-debug qt6-core:x64-linux-debug qt6-gui:x64-linux-debug
  

  或直接安装完整Qt6调试包：

  vcpkg install qt6:x64-linux-debug
  

• 重新编译并验证
  执行编译后再次检查链接情况：

  cmake --build build_debug --config Debug -j12
  ldd ./build_debug/Pdf4QtViewerLite/Pdf4QtViewerLite
  

  正常情况下会看到链接路径指向vcpkg目录下的Qt调试库（如$VCPKG_PATH/installed/x64-linux-debug/lib/libQt6Widgets.so.6）

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