VS2019调试boost对象序列化到XML代码时出现LNK2019链接错误

这是典型的C++模板函数未正确实例化导致的链接错误，核心问题是ABC类针对boost::archive::xml_oarchive类型实例化的serialize成员函数没有找到对应实现。

具体产生原因 #

C++模板函数的定义必须对编译器可见才能完成自动实例化，你只在类声明中给出了serialize模板函数的声明，要么没有提供实现，要么把实现放在了独立的.cpp文件里。编译调用序列化逻辑的代码时，编译器看不到serialize的实现，无法生成对应xml_oarchive类型的实例化代码，链接阶段就会报未定义外部符号错误。

有两种可行的解决方式，按需选择即可：

方案1：将serialize实现放入头文件（最常用） #

直接在ABC类定义的头文件中补充serialize的实现代码，示例如下：

class ABC
{
// 原有类定义保持不变
private:
    friend class boost::serialization::access;

    template<class Archive>
    void serialize(Archive& ar, const unsigned int /*version*/)
    {
        // 补充你要序列化的成员即可，这里以data为例
        ar & BOOST_SERIALIZATION_NVP(data);
    }
    
    int data;
};

如果不想把实现写在类内部，也可以在头文件的类定义外补充实现：

template<class Archive>
void ABC::serialize(Archive& ar, const unsigned int /*version*/)
{
    ar & BOOST_SERIALIZATION_NVP(data);
}

方案2：显式实例化模板（适合要把实现放在cpp文件的场景） #

如果你希望把serialize的实现放在单独的.cpp文件中，需要在该cpp文件末尾显式实例化你需要用到的Archive类型对应的函数：

// 放在serialize实现所在的cpp文件末尾
#include <boost/archive/xml_oarchive.hpp>
template void ABC::serialize<boost::archive::xml_oarchive>(boost::archive::xml_oarchive& ar, const unsigned int version);

// 如果后续需要支持XML反序列化，还要补充xml_iarchive的实例化：
// #include <boost/archive/xml_iarchive.hpp>
// template void ABC::serialize<boost::archive::xml_iarchive>(boost::archive::xml_iarchive& ar, const unsigned int version);

额外检查项 #

完成上述修改后如果还有链接错误，检查项目配置：

• 确认Boost库的附加包含目录、附加库目录配置正确，和你使用的Boost 1.76.0版本、项目的目标架构（x86/x64）、运行库版本（MT/MD等）匹配
• 确认链接器输入中已经包含了Boost.Serialization对应的lib文件，或者你没有禁用Boost的自动链接机制。

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