链接错误（undefined reference）指链接器找不到函数或变量的实际定义，主因有四：一、声明未定义，需检查extern变量和非内联函数是否在.cpp中实现；二、未链接目标文件或库，确保所有源文件参与编译并正确配置库路径；三、C/c++混合调用时未用extern "C"处理name mangling；四、模板定义未置于头文件或未显式实例化。
链接错误（Linker Error）在 C++ 中通常表现为 undefined reference to ‘xxx’，意思是：编译器已经顺利生成了目标文件（.o/.obj），但链接器在拼装最终可执行文件时，找不到某个函数、变量或成员的**实际定义**。这不是语法问题，而是“声明有了，实现没找到”。
常见原因一：声明了但没定义函数或变量
比如头文件里写了 extern int g_value; 或 void foo();，但对应源文件里漏掉了 int g_value = 42; 或 void foo() { ... }。C++ 区分声明（告诉编译器“有这东西”）和定义（真正分配内存或提供代码）。链接器只认定义。
- 检查所有
extern变量是否在某个 .cpp 文件中有且仅有一处定义 - 检查每个非内联函数是否在 .cpp 文件中实现了，而不是只留在头文件里（除非是 inline 或模板）
- 类的成员函数如果在类外定义，确保该定义所在的 .cpp 被编译进项目
常见原因二：忘记链接目标文件或库
你写了 foo.cpp 实现了 foo()，但编译命令只写了 g++ main.cpp -o app，没加 foo.o 或 foo.cpp —— 链接器当然找不到 foo 的定义。
- 用
g++ main.cpp foo.cpp -o app确保所有相关源文件都参与编译链接 - 如果用了静态库（.a）或动态库（.so/.dll），确认加了
-lxxx和-L/path/to/lib - 检查 ide（如 VS、Clion）的项目设置：是否把新增的 .cpp 文件加入了构建目标？
常见原因三：C 和 C++ 混合调用时的 name mangling 问题
C++ 编译器会对函数名做修饰（mangling），比如 void log(int) 可能变成 _Z3logi；而 C 编译器不会。如果你在 C++ 里调用 C 函数但没加 extern "C" 声明，链接器就对不上号。
立即学习“C++免费学习笔记（深入）”；
- 在 C++ 代码中包含 C 头文件时，用
extern "C" { #include "c_header.h" } - 或者在 C 头文件里加保护：
#ifdef __cplusplus<br> extern "C" {<br>#endif<br>// 原有声明<br>#ifdef __cplusplus<br> }<br>#endif
常见原因四：模板定义位置不当
模板的定义（不只是声明）必须在头文件中，或在被实例化的翻译单元中可见。如果把模板函数的实现写在 .cpp 里，其他 .cpp 文件调用时只会看到声明，链接时找不到实例化后的代码。
- 把模板类/函数的全部实现放在头文件（.h 或 .hpp）里
- 或者使用显式实例化：在模板 .cpp 文件末尾写
template void my_swap<int>(int&, int&);</int>，告诉编译器“这里必须生成这个版本” - 避免在 .cpp 中只声明模板、指望别处定义
基本上就这些。遇到 undefined reference，先看报错里那个符号是谁、来自哪个文件，再顺藤摸瓜查它在哪声明、在哪定义、定义是否被编译、是否被链接——不复杂但容易忽略。