使用CMake构建含Vcpkg版OpenCV的C++项目时依赖查找失败求助

你的问题根源在于手动指定单个依赖路径破坏了Vcpkg的工具链集成逻辑，导致依赖版本、架构不匹配，以及依赖传递失效。以下是针对性的解决步骤：

1. 彻底清理旧构建缓存 #

• 删除项目下的build目录（或其他自定义构建输出目录）
• 在VSCode中执行：Ctrl+Shift+P → 选择"CMake: Delete Cache and Reconfigure"，清空插件缓存

2. 强制使用Vcpkg工具链管理所有依赖 #

在CMakeLists.txt开头必须指定Vcpkg工具链文件，且要放在project()指令之前或紧接其后：

cmake_minimum_required(VERSION 3.28)
# 替换为你实际的Vcpkg安装路径，用正斜杠或双反斜杠
set(CMAKE_TOOLCHAIN_FILE "C:/vcpkg/scripts/buildsystems/vcpkg.cmake" CACHE STRING "Vcpkg toolchain file")

project(HelloOpenCV)

find_package(OpenCV REQUIRED)

add_executable(HelloOpenCV main.cpp)
target_link_libraries(HelloOpenCV PRIVATE ${OpenCV_LIBS})

注意：绝对不要手动设置OpenCV_DIR、Protobuf_DIR这类变量，Vcpkg工具链会自动处理所有依赖的路径与版本一致性

3. 确保OpenCV与MinGW架构完全匹配 #

• 确认你安装的是对应MinGW-w64 x64版本的OpenCV，执行以下命令重装（如果之前装错了）：

  # 静态库版本
  vcpkg install opencv:x64-mingw-static
  # 或动态库版本
  vcpkg install opencv:x64-mingw-dynamic
  

• MinGW-w64 13.2.0默认是x64架构，必须安装带x64-mingw后缀的包，禁止混用x86版本

4. 修复TIFF依赖找不到的问题 #

当使用Vcpkg工具链时，依赖会自动传递，但如果仍报错：

• 先检查Vcpkg是否已安装对应架构的TIFF：

  vcpkg list | findstr tiff
  

• 若未安装，手动安装匹配版本：

  vcpkg install tiff:x64-mingw-static
  

• 确保CMakeLists.txt中没有手动设置TIFF_DIR，避免干扰Vcpkg的依赖查找逻辑

5. 验证CMake生成器配置 #

在VSCode中执行CMake配置时：

• Ctrl+Shift+P → "CMake: Configure"，选择MinGW Makefiles作为生成器
• 若MinGW未被自动识别，可在配置选项中添加：

  -DCMAKE_C_COMPILER=C:/mingw64/bin/gcc.exe
  -DCMAKE_CXX_COMPILER=C:/mingw64/bin/g++.exe
  

  替换为你实际的MinGW安装路径

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