C# 條件編譯指令：#if / #elif / #else / #endif / #define 控制代碼編譯

條件編譯指令允許在編譯階段根據符號定義決定代碼是否包含在輸出程序集中，實現「零成本」的調試/發布切換、平台差異隔離、功能開關等。本文講解語法、符號定義方式、常見場景與最佳實踐。

基礎語法

#define DEBUG_LOG   // 定義符號 (必須在文件頂部、命名空間之前)

#if DEBUG_LOG
    Console.WriteLine("調試日志：進入 Info() 方法");
#elif RELEASE_LOG
    Logger.Info("發布版日志");
#else
    // 無符號時編譯此分支
#endif

// 方法級控制示例
public string GetInfo()
{
#if (HYWORK == false)
    return "can not if";
#elif (HYWORK == true)
    return "do if";
#endif
}

符號定義方式

1. 源碼中：#define SYMBOL（文件級，頂部）。
2. 項目屬性：專案屬性 → Build → Conditional compilation symbols（如 DEBUG;TRACE;MYFEATURE），影響整個項目。
3. 命令行編譯：csc /define:DEBUG /define:MYFEATURE Program.cs。
4. 預定義符號：DEBUG（Debug 配置自動定義）、TRACE、NETFRAMEWORK、NETCOREAPP、NETSTANDARD 等。

常見運算符

典型應用場景

• 調試代碼隔離：#if DEBUG ... #endif 包裹性能探測、詳細日志、斷言。
• 平台差異：#if NET472 ... #elif NETCOREAPP3_1 ... #endif 適配不同 TFM。
• 功能開關：#if ENABLE_NEW_UI ... #endif 灰度發布新功能。
• 許可證/版本控制：#if TRIAL_VERSION ... #elif PRO_VERSION ... #endif。

最佳實踐

1. 符號命名統一大寫下劃線：FEATURE_XYZ。
2. 避免在條件編譯塊中包含過多邏輯，導致代碼可讀性下降；優先考慮運行時配置（IOptions、特性標記）。
3. 使用 ConditionalAttribute 標記方法替代 #if 包裹調用點：[Conditional("DEBUG")] void Log(...)，調用點無需修改，編譯器自動裁剪。
4. 配合 #warning 標記待辦/棄用代碼：#warning "此方法將在 v2.0 移除，請改用 NewMethod()"。

1. 上一篇文章： C# 事件與索引器深度解析：從原理到最佳實踐
2. 下一篇文章： C# 實現陽曆轉農曆（陰曆）算法：含數據表、存儲過程與調用示例

關於C#

C# 開發 WPF/Silverlight 動畫與遊戲系列教程（三十）：大法師——華麗群攻魔法實作

前言 從紅白機到 PS3，經典遊戲角色常駐夢境。UO 開啟網

WPF/Silverlight 遊戲開發教程 (1)：Storyboard 時間軸動畫入門 — 聲明式屬性漸變、Canvas 絕對定位、動態資源註冊

系列教程緣起與定位 自 QXGame (WPF GAME E

Head First C# 中文版第二章 第 46 頁：程式來源與 .NET Framework

原始碼檔案與方案 專案即一組原始碼檔案，可複製資料夾完整移

Visual C# 2005 使用 SqlCommand 執行 T-SQL 查詢：標量值與參數化查詢實務

前言 在 ADO.NET 中，SqlCommand 是向 S