【C++】template方法undefined reference to

这周本来要写几个前端的知识点，因为刚好最近接了一个前端的项目。但是这个有点复杂，自己还没学明白，没法写文章出来。就写一个这周开发遇到的问题。

另外吐槽 VS Code 提升了 SSH 需要的对方服务器的 linux 版本，都连不上了，还得降级 VS Code。

模板方法的错误使用

templateFunc.h
我们在头文件里声明了一个模板方法

template <typename T>
T &addTwo(T &a, T &b);

templateFunc.cpp
但是把实现写到源文件中

#include "templateFunc.h"

template <typename T>
T &addTwo(T &a, T &b)
{
    return a + b;
}

test.cpp
此时，如果直接在另一个源文件使用这个方法

#include <iostream>
#include "templateFunc.h"

int main()
{
    int a = 1, b = 2;
    double c = 1.5, d = 1.5;
    std::cout << "plus1:" << addTwo(a, b) << std::endl;
    std::cout << "plus2:" << addTwo(c, d) << std::endl;
}

就会报方法找不到的问题：

C:/tools/mingw-w64-gcc-13.2-stable-r40/bin/../lib/gcc/i686-w64-mingw32/13.2.0/../../../../i686-w64-mingw32/bin/ld.exe: C:\Users\TIHONG~1\AppData\Local\Temp\cc3xblPf.o:test.cpp:(.text+0x5b): undefined reference to `int& addTwo<int>(int&, int&)'
C:/tools/mingw-w64-gcc-13.2-stable-r40/bin/../lib/gcc/i686-w64-mingw32/13.2.0/../../../../i686-w64-mingw32/bin/ld.exe: C:\Users\TIHONG~1\AppData\Local\Temp\cc3xblPf.o:test.cpp:(.text+0xa3): undefined reference to `double& addTwo<double>(double&, double&)'
collect2.exe: error: ld returned 1 exit status

解决

事实上，若多个C++文件编译时，某个模板方法如果没有被使用，编译器就不会进行编译。而编译到另一个文件时，未编译的方法就找不到原型。

解决办法有两个，一个是直接把模板方法的实现写在头文件里，不再分离声明与实现。另一个就是对模板方法显式实例化。如下：

#include "templateFunc.h"

template <typename T>
T addTwo(T &a, T &b)
{
    return a + b;
}

template int addTwo<int>(int &a, int &b);
template double addTwo<double>(double &a, double &b);

事实上，这段代码我并没有编译过，而且报的错没有变化。我将函数中所有以模板类型T为类型的参数以及函数的返回值都改成了非模板参数就编译过了，我也很困惑，感觉自己的写法没有语法错误。