C# 預處理指令深度解析：#line 與 #pragma warning 實戰

前言

C# 預處理指令雖不影響 IL 產出，卻能控制編譯器行號報告、警告抑制、偵錯體驗、原始碼產生器整合等關鍵行為。本文深入解析 #line 與 #pragma warning 兩大實用指令。

#line：重寫編譯器行號與檔案名

基本語法

#line number ["filename"]
#line default
#line hidden

核心用法示範

class Demo
{
    static void Main()
    {
        #line 200 "CustomFile.cs"
        int i;                    // CS0168 將回報：CustomFile.cs(200,9)
        #line default
        char c;                   // CS0168 回報：實際檔案第 9 行
    }
}

四大實戰場景

關鍵細節

• #line hidden 不影響 錯誤行號回報，僅影響偵錯器逐步執行行為。
• #line default 恢復預設行號計算（含前面所有隱藏行）。
• 檔案名需雙引號包裹，支援相對/絕對路徑，編譯器不驗證檔案是否存在。

#pragma warning：精準控制警告輸出

語法與參數

#pragma warning disable  警告清單   // 關閉指定警告
#pragma warning restore  警告清單   // 恢復預設行為
#pragma warning disable            // 關閉所有警告（不建議）
#pragma warning restore            // 恢復所有警告

警告編號不含 CS 前綴，如 0168、0618、0414。

實戰範例：抑制特定區塊警告

// 關閉：未使用變數(0168)、過時成員(0618)、欄位未讀取(0414)
#pragma warning disable 0168, 0618, 0414

public class LegacyInterop
{
    int unusedField = 10;                    // 0168 不會顯示
    [Obsolete("請用 NewMethod")]             // 0618 不會顯示
    public void OldMethod() { }

    public void Caller()
    {
        int temp = 5;                        // 0168 不會顯示
        OldMethod();                         // 0618 不會顯示
    }
}

#pragma warning restore 0168, 0618, 0414    // 恢復專案級設定

專案級 vs 檔案級 vs 區塊級

常見警告編號速查

進階技巧：條件式編譯配合

#if DEBUG
#pragma warning disable 0162  // 無法到達的程式碼（DEBUG 區塊常見）
#endif
    // 僅 DEBUG 執行的驗證邏輯
#if DEBUG
#pragma warning restore 0162
#endif

偵錯器互動：#line hidden 實測

using System;

class DebugDemo
{
    static void Main()
    {
        Console.WriteLine("正常行 1");      // 斷點 1：會停
        #line hidden
        Console.WriteLine("隱藏行");        // 斷點 2：不會停，F11 直接跳過
        #line default
        Console.WriteLine("正常行 2");      // 斷點 3：會停
    }
}

此特性常用於：原始碼產生器輸出的對應關係、AOP 編織碼、框架內部樣板碼。

最佳實務總結

1. 區塊級抑制優於檔案級：最小化影響範圍，避免掩蓋真實問題。
2. 註解說明原因：// #pragma warning disable 0618 - 相容舊版 API，v2.0 移除。
3. 定期清理：專案里程碑檢視 #pragma warning 使用情況，已遷移完成者移除抑制。
4. 不要抑制 CS0162/CS0219 等邏輯警告：通常代表真正 Bug，應修正程式碼而非隱藏。
5. 原始碼產生器開發者：務必輸出 #line 指令，大幅提升使用者體驗。