在vcpkg中使用自定义triplet时解决ICU库重复安装问题

问题背景

在使用vcpkg进行依赖管理时，开发者有时需要创建自定义的triplet（三元组）来满足特定的构建需求。然而，有用户报告在使用自定义triplet（custom-x64-win）时，ICU库会被同时安装到两个目录中：既安装到预期的自定义triplet目录（vcpkg_installed/custom-x64-win），又安装到默认的x64-windows目录。

问题现象

当开发者使用如下命令安装依赖时：

vcpkg install --triplet=custom-x64-win

发现ICU库被同时安装到：

1. vcpkg_installed/x64-windows
2. vcpkg_installed/custom-x64-win

而其他库则按照预期只安装到自定义triplet目录中。

问题原因

这个问题的根本原因在于vcpkg的依赖解析机制。ICU库在某些情况下会被作为"宿主工具链"的依赖安装，而不仅仅是目标平台的依赖。默认情况下，vcpkg会使用x64-windows作为宿主工具链的triplet，即使我们指定了自定义的目标triplet。

解决方案

要解决这个问题，我们需要明确指定宿主工具链的triplet，使其与目标triplet保持一致。可以通过以下命令实现：

vcpkg install --host-triplet=custom-x64-win

或者同时指定目标和宿主triplet：

vcpkg install --triplet=custom-x64-win --host-triplet=custom-x64-win

技术细节

1. Triplet概念：在vcpkg中，triplet用于描述目标平台的配置，包括架构、CRT链接方式、库链接方式等。自定义triplet允许开发者覆盖默认设置。

2. 宿主与目标工具链：

   • 目标工具链（--triplet）：用于构建最终应用程序的配置
   • 宿主工具链（--host-triplet）：用于构建构建过程中需要的工具的配置

3. ICU的特殊性：ICU库在某些构建过程中可能被用作工具链的一部分，因此会被宿主工具链使用。

最佳实践

1. 当使用自定义triplet时，建议总是显式指定宿主triplet
2. 可以在CI/CD脚本中设置默认的宿主triplet，避免每次手动指定
3. 检查自定义triplet文件，确保所有配置项（如VCPKG_LIBRARY_LINKAGE）都正确设置

总结

vcpkg的triplet机制提供了强大的灵活性，但也需要开发者理解宿主与目标工具链的区别。通过正确使用--host-triplet参数，可以避免ICU等库的重复安装问题，确保构建系统的整洁和高效。对于复杂的项目，建议详细规划triplet的使用策略，并在团队文档中明确记录这些约定。