结论是：90%的undefined reference错误源于链接命令缺失-l/-l、库与目标文件顺序颠倒、静态库内无有效符号，或c++未用extern "c"适配c库。
直接说结论：不是库没做对，而是链接时没让链接器“看见”符号——90% 的 undefined reference 错误都卡在这三步上。
链接命令里漏了 -l 或 -L
静态库文件（比如 libmath.a）本身只是归档，链接器不会自动扫描当前目录。必须显式告诉它：
• 库在哪（-L. 表示当前目录）
• 要用哪个库（-lmath 对应 libmath.a，注意去掉 lib 前缀和 .a 后缀）
常见错法：gcc main.c -o main —— 这根本没提库，链接器当然找不到 add()；
正确写法：gcc main.c -L. -lmath -o main
main.o 和 libxxx.a 顺序颠倒
GNU ld 按从左到右顺序处理参数，只“向前”解析依赖。
错误示例：gcc -lmath main.c -o main —— 链接器先看到 -lmath，但此时还没读 main.o，不知道要什么符号，直接跳过该库；
正确顺序必须是：gcc main.c -L. -lmath -o main 或 gcc main.o -L. -lmath -o main
如果用了多个库且有依赖关系（比如 A 依赖 B），则顺序应为：main.o -lA -lB，不能反过来。
静态库内部没包含目标文件，或目标文件没导出符号
用 ar 打包时，必须确保 .o 文件已编译且含有效符号：
• 先检查源文件是否定义了函数：比如 math_utils.c 里真有 int add(int a, int b) { return a + b; }
• 编译时别漏 -c：gcc -c math_utils.c -o math_utils.o
• 归档时确认内容：ar -t libmath.a 应输出 math_utils.o；
• 查看符号是否存在：nm libmath.a | grep add，若无输出，说明该函数未被编译进目标文件（常见于宏开关屏蔽、条件编译未命中、或函数声明但未定义）。
C++ 项目里函数名被 mangling 导致链接失败
如果你的静态库是 C++ 编写的，而主程序是 C，或者头文件没加 extern "C"，链接器看到的是类似 _Z3addii 这样的符号，而非裸名 add。
解决方法只有两个：
• 在头文件中包裹声明：
#ifdef __cplusplus
extern "C" {
#endif
int add(int a, int b);
#ifdef __cplusplus
}
#endif
• 或者确保主程序也用 C++ 编译（
g++ 而非 gcc），且调用方式一致。不加
extern "C" 的 C++ 静态库，几乎不可能被 C 程序直接链接成功。
最容易被忽略的一点：静态库不是“放那儿就能用”的黑盒，它本质是一堆 .o 的打包，链接器只在需要时才从中抽符号。所以哪怕 libxxx.a 文件存在、路径正确、名字对得上，只要里面没对应符号，或链接顺序不对，就必然报 undefined reference —— 它不是运行时报错，而是链接期确定性失败。
