C 語言條件編譯完全指南：#undef、#ifdef、#if、#error 實戰

C 語言條件編譯完全指南：#undef、#ifdef、#if、#error 實戰

條件編譯是 C 預處理器的強大功能，可根據編譯時條件決定程式碼是否被編譯，常用於跨平台移植、除錯開關、防止重複包含頭檔等場景。

1. #undef：取消宏定義

#define R 3
#undef R
#define R 4  // 合法：先取消再重新定義

• 即使未定義也可安全使用 #undef。
• 常用於「不確定前方是否已定義同名宏」的防禦性程式設計。

2. #ifdef / #ifndef / #else / #endif

防止頭檔重複包含（標準守衛模式）

#ifndef HEADER_FILENAME
#define HEADER_FILENAME
// 頭檔內容
#endif

條件編譯程式碼區塊

#if MACHINE == 68000
    int x;
#else
    long x;
#endif

• #ifdef MACRO：若 MACRO 已定義則編譯後續區塊。
• #ifndef MACRO：若 MACRO 未定義則編譯後續區塊。
• 可巢狀使用，但預處理器不識別大括號 { }，必須用 #else/#endif 界定區塊。

3. #if / #elif：整數常數表達式判斷

#if defined(IBMPC)
    #include "ibmpc.h"
#elif defined(VAX)
    #include "vax.h"
#elif defined(MAC)
    #include "mac.h"
#else
    #include "general.h"
#endif

• defined(NAME) 為預處理器運算子，定義過回傳 1，否則 0。
• 優於 #ifdef 之處：可搭配 #elif 實現多重互斥分支。
• 表達式中可使用關係/邏輯運算子，但不可使用 sizeof、型別轉換、浮點數。

4. #error / #line / #pragma（簡介）

• #error "訊息"：強制編譯器報錯並顯示訊息，常用於編譯期斷言（如檢查架構支援）。
• #line 100 "myfile.c"：修改編譯器報告的行號與檔名，常用於自動產生程式碼工具。
• #pragma：編譯器專用指令（如 #pragma once、#pragma pack），不可移植，謹慎使用。

5. 實戰最佳實踐

1. 頭檔守衛：採用 #pragma once（現代編譯器支援）或傳統 #ifndef 模式。
2. 功能開關：#define DEBUG 1，程式中用 #if DEBUG 包裹除錯碼，發布時改 0 即可移除。
3. 跨平台抽象：針對不同 OS/架構定義統一介面，實作細節置於條件區塊。
4. 避免濫用：過度條件編譯導致程式碼難讀、難測試，優先考慮執行期多型或建置系統配置。