静态库使用需严格匹配命名、路径和链接顺序：lib前缀与-l参数必须一致，-L须在-l前，-I解决头文件查找，ar rcs不可省略s，否则链接失败。
静态库不是“编译完就能用”，90%的新手卡在命名、路径或链接顺序上，而不是代码本身。
lib 前缀和 -l 参数必须严格匹配
gcc 链接时用 -lxxx，它会自动去找 libxxx.a（或 libxxx.so）。如果手动建了个叫 math.a 的文件，-lmath 能找到；但要是叫 my_math.a，就得用 -lmy_math —— 不能省略 lib 前缀，也不能在 -l 后面加 lib。
-
ar rcs libutils.a utils.o→ 正确，链接用-lutils -
ar rcs utils.a utils.o→ 错误，-lutils找不到，报错cannot find -lutils - 头文件名和库名无关，
utils.h可以配libcore.a，只要函数声明与实现一致就行
链接顺序：-L 必须在 -l 之前，且 .a 文件不能放最后
gcc 对参数顺序敏感：-L 指定路径后，后续的 -l 才能生效；而如果把 .a 文件直接写在命令末尾（比如 g++ main.cpp libmath.a -o app），虽然能工作，但一旦混用多个库或系统库，就容易因符号解析失败报 undefined reference。
- ✅ 推荐写法：
g++ main.cpp -L./lib -lmath -o app - ⚠️ 危险写法：
g++ main.cpp -o app -L./lib -lmath（-o app把链接动作提前终止了） - ⚠️ 更隐蔽的坑：
g++ main.cpp -lstdc++ -lmath -L./lib -o app（-lmath在-L前，找不到库）
头文件路径没加 -I，编译阶段就挂了
静态库只解决链接问题，不解决编译问题。如果你的 main.cpp 包含了 #include "math_utils.h"，而这个头文件不在默认搜索路径（如 /usr/include）里，gcc 在编译 main.cpp 时就会报 fatal error: math_utils.h: No such file or directory，根本到不了链接那步。
- 必须显式加
-I./include（假设头文件放在./include下） -
-I和-L是两回事：-I影响预处理（找.h），-L影响链接器（找.a） - CMake 用户注意：
target_include_directories()对应-I，target_link_libraries()才对应-l和-L
ar 命令参数大小写和顺序不能错
ar 不是“随便打包”，rcs 是三个独立标志位：r（replace）、c（create）、s（write index）。漏掉 s，某些老版本 ld 会报 archive has no index; run ranlib；用 rcS（大写 S）则可能静默失败或生成不可用的归档。
- ✅ 正确：
ar rcs libfoo.a foo.o bar.o - ❌ 缺 s：
ar rc libfoo.a foo.o→ 链接时报索引缺失 - ❌ 大写：
ar rcs libfoo.a *.o→ 如果当前目录有隐藏文件（如.gitignore），*会展开并导致 ar 报错 - ? 补救：
ranlib libfoo.a可手动补索引，但不如一开始就写对rcs
真正麻烦的不是“不会做”，而是错误信息不指向真实原因：比如 undefined reference 看似函数没实现，实际可能是头文件没 -I、库名拼错、或者 -L 放错了位置。动手前先确认这四点：库文件名带 lib 前缀了吗？-I 和 -L 路径对吗？-l 写在 -L 后面了吗？ar rcs 少没少字母？
