Linux 建立靜態函式庫 (.a) 完整實戰教學：從原始碼編譯到連結驗證

靜態函式庫 (.a, Archive) 將多個目標檔 (.o) 打包成單一檔案，連結時將所需機器碼直接複製至執行檔，無執行期相依性、啟動快、部署簡單。本文以雙函式示範完整流程：原始碼編譯 → ar 打包 → 主程式連結 → 執行驗證，並說明兩種連結方式差異。

專案結構

static_lib_demo/
├── hello_first.c
├── hello_second.c
├── hello_main.c
└── Makefile (選用)

1. 撰寫原始碼

hello_first.c

#include <stdio.h>
void hello_first(void) {
    printf("hello first\n");
}

hello_second.c

#include <stdio.h>
void hello_second(void) {
    printf("hello second\n");
}

hello_main.c

#include <stdio.h>
void hello_first(void);
void hello_second(void);

int main(void) {
    hello_first();
    hello_second();
    return 0;
}

2. 編譯原始碼為目標檔

gcc -c hello_first.c -o hello_first.o
gcc -c hello_second.c -o hello_second.o

# 驗證
file hello_first.o
# hello_first.o: ELF 64-bit LSB relocatable, x86-64, version 1 (SYSV), not stripped

-c：僅編譯組譯，不連結，產生 .o 目標檔。

3. 使用 ar 建立靜態函式庫

ar -rcs libhello.a hello_first.o hello_second.o

參數說明：

• r：插入/替換模組
• c：建立新檔案不提示
• s：建立/更新符號索引 (ranlib 功能)，連結器需要此索引

驗證庫內容：

ar -t libhello.a
# hello_first.o
# hello_second.o

nm -s libhello.a
# 顯示符號表與索引

4. 連結靜態函式庫 (兩種方式)

方式一：直接指定庫檔案路徑

gcc hello_main.c libhello.a -o hello_main
./hello_main
# 輸出:
# hello first
# hello second

方式二：標準庫搜尋路徑 + -l 參數

# 1. 複製庫至標準路徑 (需 root)
sudo cp libhello.a /usr/local/lib/
sudo ldconfig

# 2. 連結時使用 -lhello (去掉 lib 前綴與 .a 後綴)
gcc hello_main.c -lhello -o hello_main2
./hello_main2
# 輸出相同

方式三：指定庫搜尋目錄 -L (不需複製至系統目錄)

gcc hello_main.c -L. -lhello -o hello_main3
# -L. 表示當前目錄為搜尋路徑

5. 靜態庫 vs 動態庫 關鍵差異

進階：Makefile 自動化建構

# Makefile
CC = gcc
AR = ar
CFLAGS = -Wall -O2
TARGET = hello_main
LIB = libhello.a
OBJS = hello_first.o hello_second.o

all: $(TARGET)

$(LIB): $(OBJS)
	$(AR) -rcs $@ $^

$(TARGET): hello_main.c $(LIB)
	$(CC) $(CFLAGS) -o $@ hello_main.c $(LIB)

%.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

clean:
	rm -f *.o $(LIB) $(TARGET)

.PHONY: all clean

make
make clean

常見問題

為何需要靜態庫？ (設計動機)

1. 介面封裝：廠商提供 .h + .a，隱藏實作細節，使用者只需知道函式簽名。
2. 程式碼重用：開發者將常用工具函式打包，專案間共用避免複製貼上。
3. 部署簡化：嵌入式、容器、無根權限環境，單一執行檔即可運行。
4. 效能微調：編譯器可對靜態連結程式碼進行跨模組最佳化 (LTO, Link Time Optimization)。

總結

Linux 建立靜態函式庫核心三步驟：gcc -c 編譯 .o → ar -rcs 打包 .a → gcc -L. -lhello 連結驗證。掌握 ar 參數 (rcs)、連結搜尋順序 (-L、-l)、符號索引 (nm -s) 即可獨立完成靜態庫開發與部署。