C++模板接口实现虚方法报LNK2001未定义外部符号问题求解

问题根因 #

你遇到的LNK2001链接错误是C++模板的常规编译限制导致的：

• 默认情况下，模板类的成员函数实现必须对调用方编译单元可见，否则编译器无法在调用方实例化模板时生成对应类型的函数代码
• 你把JSONSerdes模板的成员函数实现都放在了独立的JSONSerdes.cpp文件中，main.cpp编译时看不到这些实现，只能生成外部符号依赖，链接阶段就找不到对应JSONSerdes<long>的实现代码

解决方案（保留实现放在cpp文件的写法） #

不需要把实现移到头文件，只需要在JSONSerdes.cpp的末尾添加JSONSerdes<long>的显式实例化声明，强制编译器在编译JSONSerdes.cpp时生成你需要的long类型实例的全部实现代码：

// 放在JSONSerdes.cpp的所有函数实现之后
template class JSONSerdes<long>;

如果后续你需要支持更多的模板参数类型，比如int、std::string等，只需要在同样的位置追加对应的显式实例化语句即可：

template class JSONSerdes<long>;
template class JSONSerdes<int>;
template class JSONSerdes<std::string>;

额外检查项 #

你提到该问题和基类虚函数const签名不匹配的问题类似，可以额外确认两点避免其他问题：

• 基类SerdesTest的虚函数签名和派生类JSONSerdes的重写函数签名完全一致，包括const修饰符、参数列表、返回值类型。如果基类函数声明为virtual const char* type() const = 0;，派生类的对应声明也必须加const修饰：const char* type() const final;
• 派生类的重写函数如果添加了final修饰符，签名必须和基类完全匹配，否则会被识别为独立的新函数，不会触发多态重写

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