使用clang-cl编译Boost序列化示例时出现boost::archive::archive_exception未定义符号链接错误

我正在搭建Boost序列化教程里的demo项目，用CMake创建了适配VS2022 + clang-cl.exe的工程，我的CMakeLists.txt配置如下：

find_package( Boost REQUIRED COMPONENTS serialization )
if(Boost_FOUND)
    message( "Boost found: ${Boost_INCLUDE_DIRS}" )
    target_include_directories( ${PROJECT_NAME} PRIVATE ${Boost_INCLUDE_DIRS} )
    target_link_libraries(${PROJECT_NAME} ${Boost_LIBRARIES})
endif()

我已经确认项目确实链接了路径为..\vcpkg_installed\x64-windows\debug\lib\boost_serialization-vc143-mt-gd-x64-1_85.lib的库文件，但编译时还是碰到了两个链接错误：

lld-link : error : undefined symbol: __declspec(dllimport) public: void __cdecl boost::archive::archive_exception::`scalar deleting destructor'(unsigned int)
lld-link : error : undefined symbol: __declspec(dllimport) public: __cdecl boost::archive::archive_exception::archive_exception(class boost::archive::archive_exception const &)

问题原因分析 #

这个问题核心是编译器ABI不匹配：你用clang-cl编译自己的项目，但链接的是MSVC（Visual C++）编译的Boost库——从库文件名里的vc143就能看出来，这是VS2022的MSVC编译器编译的版本。虽然clang-cl和MSVC语法兼容，但在C++对象模型、析构函数实现这类ABI细节上存在差异，导致链接时找不到对应符号。

解决方法 #

1. 用clang-cl重新编译Boost序列化库

最彻底的解决方式是用和项目一致的编译器（clang-cl）编译Boost库，保证ABI完全匹配。如果你用vcpkg管理依赖，可以通过指定工具链来安装适配clang-cl的版本：

vcpkg install boost-serialization:x64-windows --toolchain=clangcl

安装完成后，CMake会自动找到clang-cl编译的Boost库，重新构建项目应该就能解决链接错误。

2. 检查并对齐编译选项

如果暂时不想重新编译Boost，可以先检查项目和Boost库的编译选项是否完全一致：

• 确认项目当前是Debug模式（因为你链接的是带-gd后缀的Debug库）
• 确保项目定义了BOOST_ALL_DYN_LINK宏（如果使用动态链接库），这个宏会告诉Boost头文件生成适配动态链接的代码
• 检查字符集设置：项目和Boost库的字符集必须一致（比如都是UTF-8或者多字节字符集）

3. 尝试静态链接Boost库

静态库的ABI兼容性问题比动态库少很多，可以尝试切换到静态链接模式。修改你的CMakeLists.txt，添加静态库启用的配置：

set(Boost_USE_STATIC_LIBS ON) # 启用静态链接
find_package( Boost REQUIRED COMPONENTS serialization )
if(Boost_FOUND)
    message( "Boost found: ${Boost_INCLUDE_DIRS}" )
    target_include_directories( ${PROJECT_NAME} PRIVATE ${Boost_INCLUDE_DIRS} )
    target_link_libraries(${PROJECT_NAME} ${Boost_LIBRARIES})
endif()

之后确保链接的是静态Debug库（文件名通常带s后缀，比如boost_serialization-vc143-mt-sgd-x64-1_85.lib）。

备注：内容来源于stack exchange，提问作者Zohar Levi