C / C++ / 系统课时

使用静态库与共享库

使用静态库与共享库

把可复用代码做成库后,真正容易出错的不是 ar 或 gcc -shared 本身,而是链接期和运行期使用了不同的搜索规则。本课从同一份 C 代码构建静态库与共享库,并用 SONAME、RUNPATH 和 readelf 验证动态装载链路。

学习目标

  • 能从目标文件构建 .a 静态库和带版本号的 .so 共享库。
  • 能区分链接期的 -L/-l 搜索与运行期动态装载器的库搜索。
  • 能解释 SONAME、链接名与实际共享库文件之间的关系。

准备一份可复用代码

先建立一个最小工程。头文件只暴露接口,calc.c 提供实现,main.c 作为调用方。

bash
mkdir -p libdemo/include libdemo/src libdemo/build/lib libdemo/build/bin
cd libdemo

cat > include/calc.h <<'EOF'
#ifndef CALC_H
#define CALC_H
int add(int a, int b);
#endif
EOF

cat > src/calc.c <<'EOF'
#include "calc.h"

int add(int a, int b) {
    return a + b;
}
EOF

cat > src/main.c <<'EOF'
#include <stdio.h>
#include "calc.h"

int main(void) {
    printf("%d\n", add(20, 22));
    return 0;
}
EOF

预期结果:命令无输出,并创建 include/calc.h、src/calc.c 和 src/main.c。可用下面的命令确认文件存在。

bash
find include src -maxdepth 1 -type f | sort

预期输出

text
include/calc.h
src/calc.c
src/main.c

构建并链接静态库

静态库本质上是多个目标文件的归档。链接器只从归档中取出当前程序真正引用的目标模块,并把这些机器码复制进最终可执行文件;以后运行程序时不再需要这份 libcalc.a。

bash
gcc -std=c11 -Wall -Wextra -O2 -Iinclude -c src/calc.c -o build/calc.o
ar rcs build/lib/libcalc.a build/calc.o

gcc -std=c11 -Wall -Wextra -O2 -Iinclude -c src/main.c -o build/main.o
gcc build/main.o build/lib/libcalc.a -o build/bin/app-static
./build/bin/app-static

预期输出

text
42

这里把 libcalc.a 直接写在链接命令中,避免引入额外搜索规则。也可以写成 -Lbuild/lib -lcalc:此时链接器会在 -L 指定目录中查找名为 libcalc.so 或 libcalc.a 的候选库,具体选择还受链接选项与文件是否存在影响。

构建带 SONAME 的共享库

共享库不把实现复制进主程序,而是在可执行文件中记录动态依赖。位置无关代码 -fPIC 适合被映射到不同进程地址空间;SONAME 则表示运行时应寻找的 ABI 名称,通常把主版本放在其中。

bash
gcc -std=c11 -Wall -Wextra -O2 -fPIC -Iinclude -c src/calc.c -o build/calc.pic.o
gcc -shared -Wl,-soname,libcalc.so.1 -o build/lib/libcalc.so.1.0.0 build/calc.pic.o

ln -sfn libcalc.so.1.0.0 build/lib/libcalc.so.1
ln -sfn libcalc.so.1 build/lib/libcalc.so

gcc build/main.o -Lbuild/lib -Wl,-rpath,'$ORIGIN/../lib' -lcalc -o build/bin/app-shared
./build/bin/app-shared

预期输出

text
42

三个名称承担不同职责:libcalc.so 是开发期链接名,libcalc.so.1 是 SONAME 对应的运行期 ABI 名,libcalc.so.1.0.0 是实际文件。升级到 ABI 兼容的 1.x 版本时,可以只调整 libcalc.so.1 的符号链接,而无需重新链接调用方。

静态链接与共享库装载链路

验证链接期与运行期信息

-Lbuild/lib 只解决链接阶段“去哪里找库”;程序启动后,动态装载器不会因为当初使用过 -L 就继续搜索这个目录。本例把 $ORIGIN/../lib 写入可执行文件,使运行时能相对可执行文件所在目录找到共享库。

bash
readelf -d build/lib/libcalc.so.1.0.0 | grep SONAME
readelf -d build/bin/app-shared | grep -E 'NEEDED|RUNPATH|RPATH'

预期输出的关键内容如下;十六进制标签值可能因工具链而不同,现代 GNU 工具链通常写出 RUNPATH。

text
(SONAME)             Library soname: [libcalc.so.1]
(NEEDED)             Shared library: [libcalc.so.1]
(NEEDED)             Shared library: [libc.so.6]
(RUNPATH)            Library runpath: [$ORIGIN/../lib]

如果删除 build/lib/libcalc.so.1 后再次运行,链接阶段已经结束,但运行阶段会失败,因为 NEEDED 中记录的是 libcalc.so.1。排查这类问题时,应分别检查可执行文件的 NEEDED、RUNPATH/RPATH、LD_LIBRARY_PATH、ldconfig 缓存以及系统默认库目录,而不是反复修改 -L。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用静态库与共享库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通