C# 前置處理器指令入門指南（一）

什麼是前置處理器指令？

前置處理器指令以 # 開頭，**不會編譯為可執行 IL 代碼**，但會影響編譯器的編譯行為。常見用途：條件編譯、版本控制、平台適配、程式碼區塊管理。

重要區別：C# 沒有獨立的前置處理器 (C/C++ 有)，所有指令由編譯器直接處理。

核心指令詳細說明

1. #define 與 #undef：定義條件編譯符號

#define DEBUG    // 定義 DEBUG 符號
#undef TRACE     // 移除 TRACE 符號

• 符號不是變數，不儲存值，僅供 #if 判斷存在性
• 必須置於檔案最頂端，所有程式碼之前
• 無法定義常數值 (C/C++ 可用 #define MAX 100，C# 不支援)

2. #if / #elif / #else / #endif：條件編譯

根據符號決定是否編譯特定程式碼區塊：

static void PrintVersion()
{
    #if V3
        Console.WriteLine("Version 3.0");
    #elif V2
        Console.WriteLine("Version 2.0");
    #else
        Console.WriteLine("Version 1.0");
    #endif
}

3. 條件編譯的邏輯運算子

#if 和 #elif 支援：

• ==、!=：符號存在性比較
• &&、||：邏輯 AND/OR

#if DEBUG || (TRACE == true)   // 定義了 DEBUG 或 TRACE 符號
// ...
#endif

符號存在視為 true，不存在視為 false。

4. 替代方案：ConditionalAttribute

除了 #if，C# 還提供 [Conditional("SYMBOL")] 屬性標記方法，若符號未定義，方法呼叫與主體皆會被移除：

[Conditional("DEBUG")]
void Log(string msg) { Console.WriteLine(msg); }

// 發布版 (未定義 DEBUG) 時，Log() 呼叫點會被完全移除

此方式更符合現代 C# 風格，建議優先考慮。

實務應用場景

• 多版本建置：基本版/專業版/企業版功能差異
• 跨框架版本相容：.NET Framework 4.8 / .NET 6 / .NET 8 API 差異處理
• 除錯輔助代碼：僅在 DEBUG 建置包含的日誌、斷言、測試鉤子
• 平台特定代碼：Windows/Linux/macOS 特定 API 隔離

下篇預告

下一篇將介紹進階指令：

• #warning/#error 編譯期診斷
• #region/#endregion 程式碼摺疊
• #line 行號控制
• #pragma warning 精細警告控制