一個 C 程式的執行包含編譯與連結兩個階段,但在編譯之前,預處理器會先跑一輪預處理,把結果交給編譯器。由於這些指令在編譯前就已完成替換,許多場合下反而比程式執行期處理更有效率。C 語言的預處理指令可分為三類:巨集定義、條件編譯、檔案包含。本文逐一說明。
程式中經常重複使用的常量或簡短運算式,通常交給巨集處理。好處很直接:所有可調整的參數集中在一處管理,而且因為替換發生在編譯之前,效能上比定義成全域變數或函式更划算。
#include <stdio.h>
#define PI 3.14 // 巨集名稱慣例使用大寫
#define R 10
#define S 2*PI*R // 巨集可以引用其他巨集
int main(int argc, const char * argv[]) {
float r = 10.5;
double area = PI * r * r;
printf("area=%.2f\n", area);
double a = S;
printf("a=%.2f\n", a);
printf("PI=3.14\n"); // 注意輸出結果是 PI=3.14,不是 3.14=3.14
// 字串內部出現的巨集名稱不會被替換
#undef PI // 強制終止巨集定義,否則它的效力持續到檔案結尾
int PI = 3.1415926;
double area2 = PI * r * r;
printf("area2=%.2f\n", area2);
return 0;
}
巨集的本質就是在預處理階段做文字替換。這個階段完全不檢查語法是否正確,也不會處理字串字面值中出現的同名文字。理解了這一點,很多看似離奇的行為就都有了解釋。
除了單純的常量替換,巨集還能接受參數:
#include <stdio.h>
#define SUM(a,b) a+b
#define SUB(a,b) (a-b)
#define MUL (a,b) (a*b) // 這樣定義是錯的:
// 預處理器會認為巨集名稱是 "MUL",
// 而替換內容是 "(a,b) (a*b)"
int main(int argc, const char * argv[]) {
int a = 2, b = 3, c, d;
c = SUM(a, b);
printf("c=%d\n", c); // 結果:c=5
d = SUM(a, b) * 2;
printf("d=%d\n", d); // 結果:8,為什麼不是 10?
// 因為替換後變成 d = a + b * 2 = 2 + 3*2 = 8
int e = SUB(b, a) * 2;
printf("(b-a)*2=%d\n", e); // 結果:2
// 若 SUB 定義時不加括號,這裡就會變成 -1
return 0;
}
帶參數的巨集功能強大,行為上有點像函式,但差別在於它只是純文字替換,不涉及儲存空間配置、參數與回傳值的處理。也因為在預處理階段就展開,一般來說執行效率較高。
使用時有兩件事務必注意:
#define MUL (a,b) (a*b) 時,預處理器認定這是一個沒有參數的物件式巨集,MUL(x, y) 的展開結果自然會完全走樣。條件編譯讓預處理器在編譯前先判斷條件:成立就把對應的程式碼納入編譯,否則那段程式碼根本不進入編譯流程,效果等同於它不存在。
#include <stdio.h>
#define COUNT 1
int main(int argc, const char * argv[]) {
// 判斷 COUNT 巨集是否已定義
#if defined(COUNT)
// 等價寫法:#ifdef COUNT
// 若要判斷「未定義」,可用 #if !defined(COUNT) 或 #ifndef COUNT
printf("COUNT defined\n");
#endif
// 判斷 COUNT 的值是否等於 1
#if COUNT == 1
showMessage("hello,world!\n");
#else
say();
#endif
return 0;
}
這個機制在實務上有幾種常見用途:依平台切換程式碼分支、在除錯版本中啟用額外日誌、以及前面提過的標頭檔重複包含防護。最後一項尤其重要,下一節就會談到。
#include 前面已多次出現,這裡把關鍵差異再強調一次:
使用 #include <xxx> 時,預處理器只會搜尋 C 函式庫的標頭檔路徑;而使用 #include "xxx" 時,搜尋順序是:先找程式所在目錄,再找系統 PATH 定義的目錄,最後才是 C 函式庫標頭檔所在目錄。
另外還有兩個限制:
不能遞迴包含。若 a.h 包含了 b.h,b.h 就不能再回頭包含 a.h。
重複包含雖然合法,但會拖累編譯效能。看下面的例子:

這三段程式碼中,main.c 與 person.h 都包含了 message.h,而 main.c 本身又包含了 person.h。預處理階段進行替換後,main.c 中會出現兩份 #include "message.h"。雖然不會報錯,但同一份內容被展開兩次,除了浪費編譯時間,若標頭檔中定義了變數或型別,還可能直接引發重複定義的錯誤。
正確做法是用巨集做包含防護:

原理很單純:判斷某個哨兵巨集是否已定義,若未定義則先定義它。這樣一來,第二次被包含時哨兵巨集已存在,整份檔案的內容就會被條件編譯排除,不會重複展開。
#ifndef MESSAGE_H #define MESSAGE_H // 標頭檔內容 #endif
這個模式幾乎是每一個 C 標頭檔的標準配備。養成習慣,能省下大量難以追查的錯誤。
預處理指令雖然看似只是編譯前的文字加工,但實際上深刻影響著程式的結構與行為。巨集要注意括號與空白這兩個細節;條件編譯是跨平台與除錯開關的基礎;檔案包含則務必搭配哨兵巨集。這三件事做對了,專案規模放大時會輕鬆很多。