C#、C++、VB.NET 預處理指令 #define / #const 完整比較與條件編譯實戰

三大語言預處理指令對照

C# #define 核心限制與用法

// 正確：定義符號 (無值、無等號)
#define DEBUG
#define LOGGING_ENABLED

// 錯誤：C# 不支援賦值
// #define DEBUG = true      ❌
// #define MAX_COUNT 100     ❌

// 條件編譯區塊
#define TRIAL_VERSION

#if TRIAL_VERSION
    public const int MaxUsers = 10;
    public const bool EnableExport = false;
#else
    public const int MaxUsers = 10000;
    public const bool EnableExport = true;
#endif

// 多重條件
#if DEBUG && LOGGING_ENABLED
    Console.WriteLine("詳細除錯日誌已啟用");
#elif DEBUG
    Console.WriteLine("基本除錯模式");
#endif

C# 專案層面管理條件編譯符號 (推薦)

不在程式碼寫 #define，改在專案屬性設定，支援多組態切換：

1. 專案右鍵 → Properties → Build
2. Conditional compilation symbols 欄位輸入：DEBUG;TRACE;MY_FEATURE (分號分隔)
3. 不同組態 (Debug/Release) 可設定不同符號

優點：原始碼乾淨、CI/CD 易注入、組態隔離。

VB.NET #Const 進階用法

' 定義常數 (可為數值、字串、布林)
#Const VERSION = "1.2.3"
#Const IS_TRIAL = True
#Const MAX_CONNECTIONS = 50

' 條件編譯區塊
#If IS_TRIAL Then
    Public Const MaxUsers As Integer = 10
#Else
    Public Const MaxUsers As Integer = 10000
#End If

' 判斷數值
#If MAX_CONNECTIONS > 10 Then
    ' 程式碼...
#End If

' 區域摺疊 (非條件編譯，僅編輯器)
#Region "資料庫存取層"
    ' 程式碼...
#End Region

C/C++ 傳統用法與現代替代

// 傳統：防止重複包含 (Header Guard)
#ifndef MY_HEADER_H
#define MY_HEADER_H
// 宣告...
#endif

// 現代：#pragma once (支援主流編譯器)
#pragma once

// 定義常數值 (建議改用 const/constexpr)
#define PI 3.1415926535        // 預處理器替換，無型別安全
const double PI = 3.1415926535; // 型別安全、有作用域、除錯可見

// 條件編譯平台差異
#if defined(_WIN32) || defined(_WIN64)
    #define PLATFORM_WINDOWS
#elif defined(__linux__)
    #define PLATFORM_LINUX
#endif

實戰場景：跨平台/版本/功能開關

// C# 範例：API 版本相容
#if NETSTANDARD2_0
    using HttpClient = System.Net.Http.HttpClient;
#elif NET6_0_OR_GREATER
    using HttpClient = System.Net.Http.HttpClient; // 相同但可區分行為
#endif

// 功能開關
#define ENABLE_NEW_UI

public class UIManager
{
    public void Render()
    {
#if ENABLE_NEW_UI
        RenderModernUI();
#else
        RenderLegacyUI();
#endif
    }
}

// 除錯專用程式碼 (Release 自動移除)
#if DEBUG
    public void DumpInternalState() { ... }
#endif

// 靜態分析抑制
#if !CODE_ANALYSIS
    [Obsolete("內部使用")]
#endif
    internal void InternalMethod() { ... }

最佳實踐總結

1. C#：專案屬性管理符號，原始碼僅用 #if/#elif/#else/#endif。
2. VB.NET：#Const 定義常數值，#If 判斷值。
3. C/C++：#pragma once 替代 Header Guard，const/constexpr 替代常數宏。
4. 避免過度使用：條件編譯增加測試組合爆炸，優先用執行期設定 (DI、設定檔、功能旗標庫)。
5. 文件化：專案 README 列出所有條件編譯符號用途。