通过vcpkg安装CGAL库后CMake无法找到对应依赖库的问题求助

排查解决步骤 #

• 确认CGAL安装架构与项目目标架构匹配
  执行vcpkg list cgal查看已安装CGAL的triplet后缀（比如x64-windows、x86-mingw等），要和你CMake构建时指定的目标架构、编译链完全一致。如果不匹配，重新安装对应版本的CGAL：

  vcpkg install cgal:[你的目标triplet]
  # 示例：vcpkg install cgal:x64-windows
  

• 检查vcpkg toolchain的指定顺序
  CMAKE_TOOLCHAIN_FILE的配置必须放在project()指令之前，顺序错误会导致vcpkg配置不生效，正确的CMakeLists.txt顺序示例：

  cmake_minimum_required(VERSION 3.15)
  set(CMAKE_TOOLCHAIN_FILE "D:/dev/vcpkg/scripts/buildsystems/vcpkg.cmake")
  project(your_project_name)
  # 后续才是find_package等其他配置
  

  如果是通过命令行传参指定toolchain，需要首次执行CMake配置时就传入，修改配置后必须删除旧的build缓存目录重新生成。
• 验证CGAL配置文件存在
  到vcpkg安装目录下查找CGALConfig.cmake文件，路径参考：
  D:/dev/vcpkg/installed/[你的目标triplet]/share/cgal/CGALConfig.cmake
  如果该文件不存在，说明CGAL安装失败，重新执行安装命令并检查安装过程的报错信息，补全缺失的依赖。
• 手动指定CGAL_DIR验证
  上述步骤都确认无误的情况下，可以在CMake配置时手动传入CGAL_DIR参数临时验证：

  cmake .. -DCGAL_DIR=D:/dev/vcpkg/installed/x64-windows/share/cgal
  

  如果手动指定后可以找到库，说明还是toolchain配置或triplet匹配的问题，回头核对配置即可。
• 清理缓存重试
  残留的旧CMake配置缓存会导致配置不生效，直接删除整个build目录，重新执行CMake配置、构建流程即可。

补充：如果你的find_package(CGAL)指定了可选组件（如Core、Qt5等），需要确认安装CGAL时开启了对应feature，示例安装命令：vcpkg install cgal[core,qt5]:x64-windows

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