静态库必须命名为libxxx.a，链接时gcc通过-lxxx自动匹配；-L必须在-l之前；头文件需用-I指定；ar打包须用-crv参数；验证用ar -t和nm -C。
静态库文件名必须是 libxxx.a 格式
不是随便起个名就能用的。ar 打包出来的文件名本身不重要，但链接时 gcc 默认只认 libxxx.a 这种命名——-lxxx 选项会自动补上前缀 lib 和后缀 .a。比如写 -lmyutil，它就去找 libmyutil.a，找不到直接报错：cannot find -lmyutil。
常见错误现象：
- 手动打包成
myutil.a（缺lib前缀），用-lmyutil链接失败 - 打包成
libmyutil.so却想用-lmyutil静态链接（类型不匹配）
正确做法：
- 用
ar -crv libmath.a factorial.o prime.o生成 - 或先生成任意名，再重命名为
libxxx.a（如mv mylib.a libmylib.a）
链接时 -L 和 -l 的顺序不能颠倒
gcc 解析参数是从左到右的，-L 必须出现在 -l 之前，否则路径不生效。写成 gcc main.c -lmath -L./lib 是无效的——-lmath 找库时还没看到 -L 指定的路径，仍去默认路径（/usr/lib 等）搜，自然失败。
正确写法只有两种：
gcc main.c -L./lib -lmath -o app-
gcc main.c ./lib/libmath.a -o app（绕过 -l，直接给 .a 文件路径）
注意：-L./lib 中的 ./lib 是相对当前工作目录的路径；如果库在 /opt/mylib/lib，就得写 -L/opt/mylib/lib。
头文件路径要用 -I 显式指定
静态库只含二进制代码，不含头文件。编译 main.c 时，#include "mathlib.h" 这行必须让预处理器能找到 mathlib.h，否则报错：fatal error: mathlib.h: No such file or directory。
解决方法就是加 -I：
- 头文件在
./include目录：加-I./include - 头文件和源码同目录：可省略，但不推荐（破坏封装性）
- 多个头文件目录：可叠加，如
-I./include -I/usr/local/include
别指望 gcc 自动从 -L 路径里找头文件——-L 只影响链接，不影响预处理。
ar 命令的 -c -r -v 参数缺一不可
ar 是 GNU 归档工具，不是“随便打包就行”。漏掉关键参数会导致库损坏或链接失败：
-
-c：创建新归档（没这个，对不存在的.a文件会报错） -
-r：插入或替换成员（没这个，ar不会更新已有.a，也不报错，但库实际为空） -
-v：显示操作过程（非必需，但能立刻确认哪些.o真被塞进去了）
错误示例：ar libmath.a factorial.o prime.o（缺所有参数）→ 生成空文件，链接时报 undefined reference；ar -r libmath.a *.o（缺 -c）→ 若 libmath.a 不存在，命令静默失败。
标准写法：ar -crv libmath.a factorial.o prime.o。
调用前务必验证 .a 文件内容
很多问题其实出在 .a 文件本身是空的或不包含目标符号。最简单的验证方式是：ar -t libmath.a 查看归档成员列表，再用 nm -C libmath.a 看是否导出你期望的函数名（如 factorial、is_prime）。如果 nm 输出全是 U（undefined）或根本没对应符号，说明 .o 编译时可能漏了 -c，或者函数声明/定义不匹配（比如头文件里声明了 int foo()，实现却是 void foo()）。
