Linux下vcpkg集成CMake项目找不到已安装依赖包如何解决

这个问题是vcpkg双模式机制导致的典型路径匹配错误，按以下步骤排查修复即可：

• 核心根因：当项目根目录存在vcpkg.json文件时，vcpkg工具链会自动启用清单模式（manifest mode），该模式会为当前项目创建独立的依赖隔离目录，不会读取你之前通过vcpkg install doctest全局安装到vcpkg根目录installed/路径下的包，因此会出现“配置文件实际存在但CMake搜不到”的现象。
  你可以根据使用习惯二选一修复：
  1. 保留清单模式：完全清空当前CMake构建目录的缓存，重新执行配置命令即可。vcpkg会自动读取vcpkg.json中的依赖声明，自动把doctest安装到项目构建目录下的专属依赖路径，不需要提前手动全局安装依赖。
  2. 改用全局模式：删除项目根目录的vcpkg.json文件，此时vcpkg会切回全局模式，直接读取你之前手动安装的doctest包。
• 必做操作：重新配置CMake前必须清理旧缓存，之前配置失败生成的缓存文件会锁死错误的搜索路径，导致后续配置一直失败。在你的构建目录下执行以下命令清理：

  rm -rf CMakeCache.txt CMakeFiles vcpkg_installed vcpkg-manifest-install.log
  

  清理完成后再重新执行你之前带工具链参数的cmake配置命令。
• 验证排查：如果清理后仍然报错，可以在cmake配置命令后追加参数-Ddoctest_DIR=/home/bobeff/projects/cpp/vcpkg/installed/x64-linux/share/doctest临时指定包路径，若该命令能配置成功，即可确认是模式匹配或缓存问题，回到前两步操作即可。
• 版本说明：你当前使用的CMake 3.16.3、vcpkg 2022-06-17、Ubuntu 20.04的组合不存在兼容性问题，不需要升级任何组件。

配置正常完成后，你在CMakeLists.txt中编写的如下代码即可正常工作：

find_package(doctest CONFIG REQUIRED)
target_link_libraries(main PRIVATE doctest::doctest)

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