如何让vcpkg忽略内置qt5-base包，优先使用外部安装的Qt5？

出现该问题的核心原因是vcpkg工具链会在project()命令执行阶段，将自身的安装路径插入到CMAKE_PREFIX_PATH的最开头，你在CMakeLists中project()之后配置的CMAKE_PREFIX_PATH优先级低于vcpkg注入的路径，因此不会生效。可以用以下任意一种方式解决：

• 方法1：在cmake命令行显式指定前缀路径
  直接在执行cmake配置时传入CMAKE_PREFIX_PATH参数，命令行传入的参数优先级高于vcpkg的自动注入配置：

  cmake -B build -S . \
    -DCMAKE_PREFIX_PATH="~/qt/5.15.2/gcc_64" \
    -DCMAKE_TOOLCHAIN_FILE=<你的vcpkg路径>/scripts/buildsystems/vcpkg.cmake
  

• 方法2：将前缀路径配置移到project()命令之前
  如果你要把配置写在CMakeLists中，必须放在project()命令之前，保证路径添加操作早于vcpkg工具链的注入逻辑：

  cmake_minimum_required(VERSION 3.16)
  # 必须放在project()之前执行
  list(PREPEND CMAKE_PREFIX_PATH "~/qt/5.15.2/gcc_64")
  project(你的项目名称)
  
  # 后续find_package逻辑不变
  find_package(Qt${QT_VERSION_MAJOR} COMPONENTS Core REQUIRED)
  

• 方法3：直接指定Qt配置路径，跳过搜索逻辑
  直接显式设置Qt的CMake配置目录，完全避免CMake搜索其他路径的Qt版本：

  # 固定Qt5的路径写法
  set(Qt5_DIR "~/qt/5.15.2/gcc_64/lib/cmake/Qt5" CACHE PATH "Qt5安装路径" FORCE)
  # 适配QT_VERSION_MAJOR的通用写法
  # set(Qt${QT_VERSION_MAJOR}_DIR "~/qt/5.15.2/gcc_64/lib/cmake/Qt${QT_VERSION_MAJOR}" CACHE PATH "Qt安装路径" FORCE)
  
  find_package(Qt${QT_VERSION_MAJOR} COMPONENTS Core REQUIRED)
  

配置验证 #

配置完成后可以在CMakeLists中加入以下代码打印当前使用的Qt路径，确认是否符合预期：

message(STATUS "当前使用的Qt路径为: ${Qt${QT_VERSION_MAJOR}_DIR}")

也可以直接查看构建目录下的CMakeCache.txt文件中Qt5_DIR对应的取值。

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