C 語言條件編譯完整指南：#if、#ifdef、#ifndef、#elif、#else、#endif 用法詳解

條件編譯概述

預處理器根據常量表達式值或宏定義狀態，決定哪些代碼參與編譯。實現跨平台適配、調試開關、版本裁剪、防重複包含等核心功能。

指令速查表

核心用法詳解與示例

1. #if 常量表達式條件編譯

#define DEBUG 0

#if DEBUG
    #define LOG(fmt, ...) printf(fmt, ##__VA_ARGS__)
#else
    #define LOG(fmt, ...)  // 釋出版無日誌開銷
#endif

// 等價於移除 #define DEBUG 行

注意：#if 後只能跟整型常量表達式，可用 defined(MACRO) 檢查宏定義。

2. #ifdef / #ifndef 宏定義狀態檢查

// 防重複包含標準模式
#ifndef _MY_HEADER_H_
#define _MY_HEADER_H_

// 內容...

#endif

// 平台適配
#ifdef _WIN32
    #include 
    #define PATH_SEP '\\'
#elif defined(__linux__)
    #include 
    #define PATH_SEP '/'
#elif defined(__APPLE__)
    #include 
    #define PATH_SEP '/'
#else
    #error "Unsupported OS"
#endif

3. #elif 多條件鏈

#define VERSION 2

#if VERSION == 1
    void feature_v1() { ... }
#elif VERSION == 2
    void feature_v2() { ... }
#elif VERSION == 3
    void feature_v3() { ... }
#else
    #error "Unknown VERSION"
#endif

4. 組合技巧：defined() 運算符

// 檢查多個宏任一已定義
#if defined(DEBUG) || defined(VERBOSE)
    #define TRACE_ON 1
#endif

// 檢查宏未定義
#if !defined(NDEBUG)
    #define ASSERT(x) if(!(x)) abort()
#else
    #define ASSERT(x)
#endif

5. #error 強制編譯失敗

#if !defined(CONFIG_FILE) && !defined(DEFAULT_CONFIG)
    #error "Must define CONFIG_FILE or DEFAULT_CONFIG"
#endif

實戰最佳實踐

調試開關分級

#define LOG_LEVEL 2  // 0=關閉, 1=錯誤, 2=警告, 3=信息, 4=調試

#if LOG_LEVEL >= 1
    #define LOG_E(fmt, ...) fprintf(stderr, "[E] " fmt, ##__VA_ARGS__)
#else
    #define LOG_E(fmt, ...)
#endif

#if LOG_LEVEL >= 2
    #define LOG_W(fmt, ...) fprintf(stderr, "[W] " fmt, ##__VA_ARGS__)
#else
    #define LOG_W(fmt, ...)
#endif
// ...

編譯器特性檢測

#if defined(__GNUC__) && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6))
    #define HAS_CONSTEXPR 1
#else
    #define HAS_CONSTEXPR 0
#endif

頭文件護衛現代寫法

// 傳統
#ifndef _FOO_H_
#define _FOO_H_
...
#endif

// C23 / 現代編譯器支援 #pragma once (非標準但普遍支援)
#pragma once
...

常見錯誤

1. #if 條件中使用未定義標識符：視為 0，不報錯但邏輯可能錯。用 defined() 顯式檢查。
2. #else/#elif 後誤加條件：#else COND 是錯誤語法，#else 無條件。
3. 嵌套層次過深：超過編譯器限制 (通常 200+ 層) 會報錯。重構代碼結構。
4. 宏定義在 #if 之後：預處理單通道，順序敏感。定義必須在使用前。

總結

條件編譯是 C 語言靜態多態的核心手段。善用 #if/#ifdef/#ifndef/#elif/#else/#endif 實現：

• 平台無關代碼隔離
• 調試/釋出版本零成本切換
• 功能模組編譯時裁剪
• 頭文件防重複包含
• 編譯期錯誤檢查與約束

原則：條件保持簡單、分支邏輯清晰、避免深度嵌套、配合版本控制管理配置宏。