如何在vcpkg中链接Boost动态库而非静态库（VS2019环境）

问题 #

使用VS 2019、vcpkg和Boost 1.81创建C++动态链接库项目，引入Boost序列化库头文件后出现以下现象：

• vcpkg设置为使用静态库时，编译正常
• 切换为“使用静态库”=“否”（即使用动态Boost库）时，触发大量C2491编译错误
• 仅在添加非标准Boost库的portable_binary_iarchive相关文件到项目时才会出现该问题

错误信息如下：

Severity    Code    Description Project File    Line    Suppression State
Error   C2491   'boost::archive::detail::archive_serializer_map<Archive>::insert': definition of dllimport function not allowed C:\dev\vcpkg\installed\x86-windows\include\boost\archive\impl\archive_serializer_map.ipp    41  
Error   C2491   'boost::archive::detail::archive_serializer_map<Archive>::erase': definition of dllimport function not allowed  C:\dev\vcpkg\installed\x86-windows\include\boost\archive\impl\archive_serializer_map.ipp    49  
Error   C2491   'boost::archive::basic_binary_iprimitive<Archive,Elem,Tr>::basic_binary_iprimitive': definition of dllimport function not allowed   C:\dev\vcpkg\installed\x86-windows\include\boost\archive\impl\basic_binary_iprimitive.ipp   146 
Error   C2491   'boost::archive::basic_binary_iprimitive<Archive,Elem,Tr>::~basic_binary_iprimitive': definition of dllimport function not allowed  C:\dev\vcpkg\installed\x86-windows\include\boost\archive\impl\basic_binary_iprimitive.ipp   170 
Error   C2491   'boost::archive::detail::archive_serializer_map<Archive>::insert': definition of dllimport function not allowed C:\dev\vcpkg\installed\x86-windows\include\boost\archive\impl\archive_serializer_map.ipp    41  
Error   C2491   'boost::archive::detail::archive_serializer_map<Archive>::erase': definition of dllimport function not allowed  C:\dev\vcpkg\installed\x86-windows\include\boost\archive\impl\archive_serializer_map.ipp    49  
...[redacted]

解决方案 #

C2491错误的核心是portable_binary_iarchive相关代码在Boost动态库模式下，未正确处理Boost的DLL导出/导入宏，导致编译器尝试定义被标记为__declspec(dllimport)的函数。按以下步骤修复：

• 强制启用Boost动态库宏
  在包含任何Boost头文件之前，定义BOOST_ALL_DYN_LINK，确保Boost使用动态库模式的正确宏：

  #define BOOST_ALL_DYN_LINK
  #include <boost/archive/binary_iarchive.hpp>
  // 后续添加portable_binary相关头文件
  

  也可以直接在VS项目属性的C/C++ -> 预处理器 -> 预处理器定义中添加BOOST_ALL_DYN_LINK，作用于整个项目。

• 修正portable_binary代码的导出标记
  由于portable_binary_iarchive是Boost序列化的自定义扩展，需要为自定义归档类添加动态库导出宏：

  class BOOST_SYMBOL_EXPORT portable_binary_iarchive : public boost::archive::binary_iarchive_impl<portable_binary_iarchive, std::istream>
  {
      // 类原有定义
  };
  

  同时确保不要在项目中显式定义Boost内部模板的实现（比如archive_serializer_map的成员函数），这些实现应由Boost动态库提供。

• 确认vcpkg的Boost动态库安装
  执行以下命令确保vcpkg已正确安装Boost序列化的动态库版本：

  vcpkg install boost-serialization:x86-windows --triplet x86-windows
  

  注：x86-windows是默认动态库triplet，x86-windows-static对应静态库版本，切换模式时需匹配正确的triplet。

• 检查链接器依赖
  在VS项目属性的链接器 -> 输入 -> 附加依赖项中，确认包含Boost序列化动态库的导入库（例如boost_serialization-vc142-mt-x86-1_81.lib），vcpkg通常会自动配置，若异常可手动添加。

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