非主类中使用C++模板异常，出现LNK2005与LNK1169链接错误

场景说明 #

尝试在非主文件中定义模板函数及调用它的普通函数，运行时出现重复定义的链接错误，仅将模板代码移至主文件时才能正常运行。

主文件代码（Source1.cpp） #

#include "AddSubtract.cpp"
#include <iostream>
#include <string>

using namespace std;

int main() {
    templEx();
}

模板所在文件代码（AddSubtract.cpp） #

#include <iostream>
#include <string>

using namespace std;

template<typename T>
void Print(T value)
{
    std::cout << value << std::endl;
}

void templEx() {
    Print("Venezuela");
}

运行错误信息 #

错误 LNK2005: "void __cdecl templEx(void)" (?templEx@@YAXXZ) 已在 AddSubtract.obj 中定义
项目：ConsoleApplication1
文件：C:\Users\bahge\source\repos\ConsoleApplication1\ConsoleApplication1\Source1.obj
行：1
生成状态：失败

错误 LNK1169: 找到一个或多个多重定义的符号
项目：ConsoleApplication1
文件：C:\Users\bahge\source\repos\ConsoleApplication1\x64\Debug\ConsoleApplication1.exe
行：1
生成状态：失败

解决方案 #

核心原因 #

直接在主文件中包含.cpp文件会触发重复定义问题：

• AddSubtract.cpp会被单独编译为AddSubtract.obj，其中包含templEx函数的完整定义；
• 主文件Source1.cpp包含AddSubtract.cpp后，编译时会将该文件内容嵌入自身，生成的Source1.obj中也会存在templEx的定义；
• 链接器合并两个目标文件时，发现同一函数被定义两次，因此抛出错误。

正确实现方式 #

方式1：头文件+源文件分离（推荐）

1. 创建头文件AddSubtract.hpp，添加头文件保护并声明函数：

#pragma once
#include <iostream>
#include <string>

template<typename T>
void Print(T value);

void templEx();

2. 在AddSubtract.cpp中实现函数，并显式实例化模板（模板需在编译时实例化，编译器需要完整定义）：

#include "AddSubtract.hpp"

template<typename T>
void Print(T value)
{
    std::cout << value << std::endl;
}

// 显式实例化当前需要的模板类型
template void Print<const char*>(const char*);

void templEx() {
    Print("Venezuela");
}

3. 主文件修改为包含头文件：

#include "AddSubtract.hpp"
#include <iostream>
#include <string>

using namespace std;

int main() {
    templEx();
}

方式2：将模板定义全部放入头文件

若无需分离声明与实现，可直接将所有代码放入带保护的头文件中：

#pragma once
#include <iostream>
#include <string>

template<typename T>
void Print(T value)
{
    std::cout << value << std::endl;
}

void templEx() {
    Print("Venezuela");
}

主文件包含该头文件即可正常编译运行。

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