C++模板库编译出现ld未定义引用错误的原因排查

核心问题：C++模板的编译特性 #

C++模板是编译时实例化的——编译器只有在看到具体的模板实例（比如MyClass<int>）被实际使用时，才会生成对应的类和成员函数的机器码。

你把模板成员函数的实现单独放在lib.cc里，编译这个文件的时候，编译器完全不知道后续test.cc会用到MyClass<int>这个实例，所以不会生成MyClass<int>::set和MyClass<int>::print的具体实现代码。而编译test.cc时，编译器只能看到头文件里的函数声明，会生成对这些函数的调用指令，但到了链接阶段，找不到对应的实现代码，自然就报未定义引用的错误。

可行的解决办法 #

有三种常用的处理方式：

• 直接把模板实现移到头文件：把lib.cc里的成员函数实现代码全部移到header.h中，和模板类的声明放在一起。这样编译器编译test.cc时，能直接拿到实现代码，当场生成MyClass<int>的实例代码，链接时就不会缺代码了。
• 在实现文件中显式实例化模板：在lib.cc的末尾加上一行显式实例化的代码：

  template class MyClass<int>;
  

  这样编译lib.cc时，编译器会主动生成MyClass<int>的所有成员函数代码，链接阶段就能找到对应的实现。但这种方式只适合你提前确定会用到哪些模板实例的场景。
• 拆分实现到专用模板文件并包含：把原lib.cc改成lib.tpp（后缀名可自定义，只要不是.cc/cpp就行），然后在header.h的最后加上#include "lib.tpp"。本质和第一种方法相同，只是把代码拆分到不同文件，方便管理。

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