ar rcs libname.a file1.o file2.o 是生成静态库最常用且安全的命令，其中 r 表示插入或替换成员，c 表示静默创建，s 表示写入索引；漏掉 s 会导致链接时 undefined reference 错误。
ar 命令生成静态库的基本用法
Clang 本身不打包静态库，它只负责编译出 .o 文件；真正把目标文件打包成 .a 的是 ar。最常用、最安全的命令是：ar rcs libname.a file1.o file2.o。
r 表示插入或替换成员，c 表示静默创建（不提示“creating”），s 表示写入索引（等价于后续运行 ranlib）。漏掉 s 是新手最常踩的坑——链接时会报 undefined reference，哪怕所有符号都定义了。
-
ar rc libfoo.a a.o b.o：没加s，索引缺失，链接器找不到符号表 -
ar rs libfoo.a a.o b.o：c缺失，首次创建时会警告“creating”，但不影响功能 - 如果已有
libfoo.a，ar rcs会原地更新，不会清空旧成员
为什么 clang 编译的目标文件要加 -fPIC 才能进静态库？
通常不用。静态库里的 .o 不需要 -fPIC；那是共享库（.so）的要求。加了反而可能引发奇怪的重定位警告，尤其在 ARM 或 RISC-V 平台。
唯一例外是：你打算把该静态库再链接进一个共享库，并且目标平台对“静态库中含非 PIC 目标文件”有严格限制（如某些 Android NDK 配置）。这时才需统一用 clang -fPIC -c foo.c。
- 正常情况：
clang -c foo.c→foo.o→ar rcs libfoo.a foo.o - 若用于构建 .so：确认链接命令里是否含
-shared，再决定是否补-fPIC -
-fPIC会增大代码体积、略微降低性能，静态库无此必要
ar 命令常见错误和对应修复
报错 ar: bad option -- 'z'：你用了 GNU ar 的扩展选项（如 z 压缩），但系统是 macOS 或 BSD 默认的 ar。macOS 的 ar 不支持压缩，也不需要——.a 本质就是归档，不是 zip。
报错 ar: libfoo.a: No such file or directory：路径写错，或当前目录不对。注意 ar 不自动创建父目录，lib/ 不存在时 ar rcs lib/foo.a *.o 会失败。
- 跨平台可移植写法：始终用
ar rcs，别用ar crs（顺序在 BSD 上敏感） - 检查是否真有
.o：运行ls *.o，空匹配会导致ar报 “no input files” - 避免通配符失效：在 Makefile 中用
$(OBJS)显式列出，而非依赖 shell 展开
静态库符号可见性与 nm / ar -t 的调试技巧
链接失败时，别急着改代码，先用 nm -C libfoo.a 看符号是否存在、是否为 T（全局定义）或 U（未定义）。若只有 U，说明该 .o 本身没实现函数，只是声明。
ar -t libfoo.a 列出成员名，确认所有预期的 .o 都在里面；ar -x libfoo.a 可解包验证单个目标文件内容。
-
nm -gC libfoo.a | grep my_func快速定位符号是否导出 - 如果
nm输出为空，可能是.o编译时加了-fvisibility=hidden，且没显式标记__attribute__((visibility("default"))) - 静态库不解决符号冲突，多个
.o定义同一全局符号时，链接器取第一个，不会报错——得靠nm主动查
实际项目里，ar 这步看似简单，但符号索引缺失、目标文件遗漏、平台 ar 行为差异这三处最容易卡住一整天。动手前先 ls *.o 和 nm -C 看一眼，比反复改 CMakeLists 快得多。
