C / C++ / 系统课时
用 ar 创建一个静态库
用 ar 创建一个静态库
ar 可以把一个或多个目标文件归档成 Unix 风格静态库。完整流程是先把库源码编译为 .o,再用 ar 生成 .a,最后让应用在链接阶段使用它。本节用一个可运行示例完成创建、检查、链接与执行。
学习目标
- 使用
gcc -c生成目标文件并用ar rcs创建静态库 - 理解
lib名字.a与链接参数-l名字的对应关系 - 通过
ar t和程序输出验证静态库确实被使用
从源文件到静态库
ar 不负责编译 C 源码,它处理的是已经生成的目标文件。典型链路是:库源码经过编译器得到 .o,多个 .o 被归档为 .a,应用源码再与这个 .a 一起交给链接器。

在多数 Unix-like 工具链中,静态库文件名通常采用 lib<name>.a。例如 libcalc.a 在链接命令中可写成 -lcalc,同时用 -L. 告诉链接器到当前目录查找库。
创建并链接一个最小静态库
下面的命令会创建三个源码文件,编译库目标文件,用 ar 生成 libcalc.a,检查归档内容,再编译并运行应用。示例依赖已安装的 gcc 和 ar。
mkdir static-lib-demo
cd static-lib-demo
cat > calc.h <<'EOF'
#ifndef CALC_H
#define CALC_H
int add(int a, int b);
#endif
EOF
cat > add.c <<'EOF'
#include "calc.h"
int add(int a, int b) {
return a + b;
}
EOF
cat > main.c <<'EOF'
#include <stdio.h>
#include "calc.h"
int main(void) {
printf("2 + 3 = %d\n", add(2, 3));
return 0;
}
EOF
gcc -Wall -Wextra -c add.c -o add.o
ar rcs libcalc.a add.o
ar t libcalc.a
gcc -Wall -Wextra main.c -L. -lcalc -o app
./app预期输出:
add.o
2 + 3 = 5如果编译器或系统工具输出了额外提示,具体文字可能不同;关键验证点是 ar t 能看到 add.o,并且最终程序输出计算结果。
看懂 ar rcs
ar rcs libcalc.a add.o 中三个常用选项分别承担不同工作:r 表示把目标文件插入归档,若同名成员已存在则替换;c 表示需要时创建归档;s 会写入符号索引,方便链接器查找库中定义的符号。
当库由多个目标文件组成时,可以一次加入多个 .o。重新编译某个源文件后,再执行同一条 ar rcs 命令即可更新对应成员。
链接顺序与常见失败
使用传统 GNU 链接器时,库通常应放在引用它的对象或源码之后,因此示例写成 gcc main.c -L. -lcalc -o app。如果把 -lcalc 提前到 main.c 之前,某些环境下可能出现未定义引用。
另一个常见错误是只有 calc.h,却没有把 libcalc.a 交给链接器。头文件只提供声明,不包含最终需要链接的函数实现。若看到 undefined reference to 'add',优先检查库是否存在、-L 路径是否正确,以及 -lcalc 是否位于合适位置。
ar 完成的是“把目标文件组织成静态库”,而真正把库代码放进可执行文件的是后续链接步骤。把这两个阶段分清,后面迁移到 CMake 的 add_library(... STATIC ...) 时会更容易理解它在自动化什么。