Linux 動態與靜態函式庫完整指南：建立、連結、版本管理與除錯

函式庫命名慣例

版本號慣例：libfoo.so.major.minor (如 libfoo.so.1.0)，搭配符號連結：

ln -sf libfoo.so.1.0 libfoo.so.1
ln -sf libfoo.so.1 libfoo.so

soname (Shared Object Name) 嵌入執行檔，載入器依 soname 尋找實際檔案，實現多版本共存。

使用函式庫實戰

假設開發套件結構

hello/
├── include/hello.h      # void sayhello();
├── lib/libhello.a       # 靜態
├── lib/libhello.so.1.0  # 動態 + 符號連結
└── docs/

1. 動態連結 (預設)

# 編譯
gcc -c testlib.c -o testlib.o -Ihello/include
# 連結 (預設搜尋 /usr/lib, /lib)
gcc testlib.o -Lhello/lib -lhello -o testlib_dynamic
# 執行需設定庫路徑
LD_LIBRARY_PATH=hello/lib ./testlib_dynamic

2. 靜態連結

# 明確指定靜態連結
gcc testlib.o -Lhello/lib -Wl,-Bstatic -lhello -Wl,-Bdynamic -o testlib_static
# 或僅有靜態庫時直接連結
gcc testlib.o -Lhello/lib -lhello -o testlib_static

-Wl,-Bstatic 傳遞給連結器 ld，後續 -l 皆為靜態；-Wl,-Bdynamic 恢復動態。

3. 混合連結範例

gcc testlib.o -o testlib \
    -Wl,-Bstatic -lhello \
    -Wl,-Bdynamic -lbye -lpthread

動態函式庫路徑解析機制

執行檔啟動時，動態連結器 ld-linux.so 依序搜尋：

1. DT_RPATH (編譯期 -Wl,-rpath 嵌入，最高優先級，但不建議濫用)
2. LD_LIBRARY_PATH 環境變數 (使用者可控，次優先)
3. DT_RUNPATH (較新 -Wl,-rpath + --enable-new-dtags，LD_LIBRARY_PATH 優先於它)
4. /etc/ld.so.conf 指定目錄 (系統級，需執行 ldconfig 更新快取)
5. 預設目錄 /lib, /usr/lib (及 /lib64, /usr/lib64)

三種部署方式比較

建立函式庫

原始碼 hello.c

#include <stdio.h>
void sayhello() { printf("hello, world\n"); }

1. 靜態函式庫

gcc -c hello.c -o hello.o -fPIC   # -fPIC 非必須但建議
ar rcs libhello.a hello.o
# 查看符號
nm -g libhello.a
# T sayhello  表示定義在本庫的全域函數

2. 動態函式庫

# 產生帶 soname 的庫
gcc -shared -fPIC -Wl,-soname,libhello.so.1 -o libhello.so.1.0 hello.o
# 建立符號連結
ln -sf libhello.so.1.0 libhello.so.1
ln -sf libhello.so.1 libhello.so
# 驗證
readelf -d libhello.so.1.0 | grep SONAME
# 0x0000000e (SONAME) Library soname: [libhello.so.1]

關鍵參數：

• -shared：產生共享物件而非執行檔。
• -fPIC：位置無關程式碼，**動態庫必須**，否則載入時需文字重定位，效能損耗大且可能被 SELinux 禁止。
• -Wl,-soname,libhello.so.1：設定 DT_SONAME，載入器依此尋找。

符號可見性與版本控制

隱藏內部符號

# 1. 編譯時 -fvisibility=hidden
gcc -fPIC -fvisibility=hidden -c hello.c
# 2. 明確匯出
#define API_EXPORT __attribute__((visibility("default")))
API_EXPORT void sayhello();

符號版本腳本 libhello.ver

LIBHELLO_1.0 {
    global:
        sayhello;
    local:
        *;
};

gcc -shared -fPIC -Wl,--version-script=libhello.ver -o libhello.so.1.0 hello.o

除錯與分析工具

常見問題排查

• error while loading shared libraries: libfoo.so.1: cannot open shared object file → 路徑問題，檢查 ldd、LD_LIBRARY_PATH、ldconfig。
• undefined symbol: xxx → 缺少連結庫或版本不符，nm -D libfoo.so | grep xxx 確認符號是否存在。
• 版本衝突 → 多個 libfoo.so 存在於搜尋路徑，用 ldd 確認實際載入哪個，調整 rpath 或 LD_LIBRARY_PATH 優先級。
• 文字重定位警告 → 未加 -fPIC，重新編譯動態庫。

結語

掌握 .a/.so 建立、連結、版本、部署、除錯全流程，是 Linux C/C++ 開發者的核心功力。關鍵口訣：**動態庫必加 -fPIC、設定 soname、善用版本腳本控制符號匯出、部署優先用 rpath/LD_LIBRARY_PATH 隔離環境**。