“undefined reference to”不是编译错误，而是链接器在合并目标文件时因找不到符号定义而报错；常见原因包括声明未实现、模板/inline函数定义不在头文件、静态库顺序错误、C/C++混用未加extern "C"。
链接阶段找不到符号：为什么 undefined reference 不是编译错误
这个错误根本不在编译阶段报出，而是在链接器（ld 或 lld）试图把目标文件拼成可执行文件时才出现。编译器看到函数声明就放行，但链接器发现某个 foo() 的定义在所有 .o 文件里都找不到，就会报 undefined reference to 'foo()'。
常见诱因包括：只声明没实现、实现放在头文件但没被包含、模板定义没展开、静态库顺序写错、C 和 C++ 混用时符号名不匹配。
inline 和模板函数必须定义在头文件里
模板函数和 inline 函数的代码必须在每个使用它们的编译单元中可见，否则链接器见不到具体实现。
- 错误写法：
template<typename T> void swap(T&, T&);只在swap.h声明，实现在swap.cpp—— 链接失败 - 正确做法：把完整定义放进头文件，或显式实例化（如
template void swap<int>(int&, int&);放在swap.cpp末尾） - 注意：即使加了
inline关键字，如果定义在.cpp里，其他源文件仍无法内联，链接时照样报错
静态库顺序和依赖关系必须从左到右满足
链接器从左到右扫描参数，遇到一个库时，只会解决它前面未解决的符号。如果 libA.a 依赖 libB.a 里的函数，命令行里 libA.a 必须出现在 libB.a 左边。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 错：
g++ main.o -lA -lB→ 若libA.a用到了libB.a的符号，链接失败 - 对：
g++ main.o -lB -lA或更稳妥地重复链接：g++ main.o -lA -lB -lA - 现代做法：改用
-Wl,--no-as-needed或直接用-L. -lA -lB并确保libB.a在libA.a右侧
C 接口函数被 C++ 编译器重命名了
当你在 C++ 里调用 C 库（比如 libz 或自己写的 utils.c），而头文件没加 extern "C"，C++ 编译器会对函数名做 name mangling，导致链接器找不到原始符号。
- 现象：
undefined reference to 'compress'，但nm libz.a | grep compress明明有 - 修复：在 C++ 文件里包含 C 头时，包一层
extern "C" { #include "zlib.h" }；或者在 C 头文件开头加#ifdef __cplusplus保护 - 验证：用
nm -C your.o看符号名是否带 C++ 编码，用nm -C /usr/lib/x86_64-linux-gnu/libz.so | grep compress对比
最常被忽略的是：哪怕你只漏掉一个 extern "C" 块，或者在头文件里写了但没覆盖全部声明，链接就可能失败 —— 这类问题不会报语法错误，只能靠符号比对定位。
