如何修复VCPKG更新CGAL 4.14后出现的libCGAL链接错误

我之前也碰到过类似的库链接问题，结合你描述的情况——CGAL 4.13正常、升级到4.14后用/MD//MDd就报LNK1104找不到指定库，大概率是VCPKG构建CGAL 4.14时的配置变化、库命名规则调整，或者工具链不匹配导致的，下面是几个实测有效的解决办法：

1. 先确认VCPKG的CGAL安装状态 #

• 打开VCPKG的命令行控制台，执行vcpkg list cgal，看看已安装的CGAL版本是不是对应你用的x64-windows架构，同时要确保debug和release版本都装了（如果两个模式都用的话）。要是缺了某个版本，直接用vcpkg install cgal:x64-windows（release）或cgal:x64-windows-debug（debug）补装。
• 划重点：VCPKG的x64-windows包对应/MD（多线程DLL）配置，x64-windows-static对应/MT（多线程静态），别搞混了，如果你选的是静态配置的包，肯定会和/MD不兼容。

2. 检查VS项目的VCPKG集成是否正确 #

• 右键你的VS项目→属性→VC++目录，确认“库目录”里已经包含了VCPKG的installed/x64-windows/lib（Release模式）和installed/x64-windows/debug/lib（Debug模式）路径，要是没自动加上，手动添进去。
• 另外，别手动在链接器输入里写死库名！比如你之前指定的libCGAL-vc140-mt-4.14-l-900.lib，CGAL 4.14可能改了命名规则，直接用VCPKG的自动依赖管理就行——只要代码里正常#include <CGAL/...>，VCPKG会自动帮你引入对应版本的库，避免版本不匹配。

3. 清理VCPKG缓存后重新构建CGAL #

有时候VCPKG的构建缓存会出问题，导致生成的库文件缺失或者命名异常：

• 先执行vcpkg remove cgal:x64-windows卸载现有版本，然后去VCPKG目录下删掉buildtrees/cgal文件夹，把残留的构建缓存清干净。
• 再重新跑vcpkg install cgal:x64-windows，等构建完成，过程中留意控制台有没有报错，确保整个构建过程是成功的。

4. 核对CGAL 4.14的实际库文件名 #

直接去VCPKG的installed/x64-windows/lib（或debug/lib）目录下看看实际生成的CGAL库叫什么：

• 要是实际文件名和链接器找的libCGAL-vc140-mt-4.14-l-900.lib不一样，比如是libCGAL-vc142-mt-4.14-l-900.lib（对应VS2019的vc142），那说明你VS的平台工具集和VCPKG构建CGAL时用的工具链不匹配！比如你用VS2019，但VCPKG是用VS2015的vc140构建的，肯定会出问题，要确保两者工具版本一致。

5. 手动指定库的临时 workaround #

如果上面的方法都没搞定，可以试试手动指定：

• 去VCPKG的库目录里找到实际存在的CGAL库文件，比如libCGAL-vc142-mt-4.14-l-900.lib，然后在VS项目属性→链接器→输入→附加依赖项里，把这个文件名替换掉原来的错误名称。
• 同时确认“链接器→常规→附加库目录”里已经包含了这个库所在的路径。

最后再检查下项目的平台工具集：右键项目→属性→常规→平台工具集，确保和VCPKG构建CGAL时用的版本一致，比如VCPKG用vc140构建的，项目就要选“Visual Studio 2015 (v140)”，不然库和编译器版本不兼容也会报链接错误。

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