C 語言模組化編程核心：頭文件與鏈接機制深度解析（下）

頭文件：批量宣告的自動化方案

上篇手動在 main.c 宣告函數原型雖可行，但隨模組增長極不擴展。頭文件將共用宣告集中管理，#include 即等同於批量複製宣告碼，實現介面與實作分離。

自定頭文件範例

/* game.h */
#ifndef GAME_H
#define GAME_H

#include 
#include 
#include 

extern int gen_rnd(void);
extern void judge(int, int);

#endif

• extern 明確標示外部鏈接，函數預設即為 extern 可省略。
• 防重複包含守衛（#ifndef）防止重複定義錯誤。
• 頭文件內可巢狀包含其他頭文件，簡化 .c 檔引用。

跨檔案調用的三要素

1. 定義端具備外部鏈接：函數預設外部鏈接；全域變數需 extern 且定義於所有函數外部。
2. 使用端正確宣告：直接寫原型或 #include 對應頭文件。
3. 鏈接期提供目標檔/庫檔：gcc main.c gen_rnd.o judge.o -o exe 或鏈接靜態庫。

頭文件搜尋路徑機制

相對路徑亦可寫於包含指令：#include "subdir/my.h"。

靜態庫：目標檔的封裝與優化

將多個 .o 打包為 .a 靜態庫：

ar rs libgame.a gen_rnd.o judge.o

• ar 專用於靜態庫建立，r 替換/新增，s 建立索引供鏈接器快速查找。
• 命名慣例：lib 前綴 + 名稱 + .a 後綴。

鏈接靜態庫的優勢

1. 指令簡潔：gcc main.c -L. -lgame -o main（-L 指定庫目錄，-l 鏈接 libgame.a）
2. 按需提取：鏈接器僅從庫中提取被引用的目標檔模組，未被引用的函數（如額外加入的 add()）不會進入最終可執行檔，減小體積。

為什麼不直接 #include "judge.c"？

直接包含原始檔會導致重複編譯、符號多重定義、編譯時間暴增，且破壞模組邊界。正確做法：.h 宣告介面，.c 實作細節，鏈接期綁定。