主要用於程式碼產生器 (Source Generator、Razor、T4、AOT 編譯器) 將產出的中間代碼映射回原始源碼位置,方便除錯與錯誤定位。
#line number ["filename"] // 設定行號、可選檔名
#line default // 恢復預設行號計數
#line hidden // 隱藏後續行,除錯器單步跳過 (不影響錯誤報告行號)
class Demo {
static void Main() {
#line 200 "GeneratedCode.cs"
int x; // CS0168 報錯行號顯示 200,檔名顯示 GeneratedCode.cs
#line default
char c; // CS0168 報錯行號顯示 9 (實際第 9 行)
}
}
#line hidden,讓開發者單步除錯時只停在 .cshtml 原始碼。解決「特定警告雜訊太大、掩蓋真正問題」的痛點。
#pragma warning disable 警告編號列表 // 關閉指定警告
#pragma warning restore 警告編號列表 // 恢復指定警告 (恢復至專案設定狀態)
0618 對應 CS0618)。restore。/nowarn:0618 或 `.editorconfig` / 專案屬性頁。| 編號 | 含義 | 典型場景 |
|---|---|---|
| 0168 | 變數已賦值但未使用 | 預留參數、暫時註解代碼 |
| 0219 | 變數被賦值但值未被讀取 | 同上 |
| 0414 | 私有欄位被賦值但未使用 | DI 注入欄位、預留擴展 |
| 0618 | 過時成員 (Obsolete) | 呼叫標記 [Obsolete] 的 API |
| 0649 | 欄位從未被賦值,將保持預設值 | 反射/序列化/Unity 欄位注入 |
public class LegacyInterop {
#pragma warning disable 0618 // 禁用 CS0618 (Obsolete)
[Obsolete("請用 NewMethod()", false)]
public void OldMethod() { }
public void Caller() {
OldMethod(); // 此處不會產生警告
}
#pragma warning restore 0618 // 恢復,後續代碼若呼叫 OldMethod 會再警告
}
#pragma warning 不影響 IntelliSense 錯誤清單顯示 (需重開 VS 或重載專案)。#pragma checksum:為除錯器指定原始檔校驗和 (Source Generator 常用)。#pragma warning suppress (Roslyn 擴展):單行抑制,語法 #pragma warning suppress CS0618。#line 是代碼生成工具的幕後英雄;#pragma warning 是維護舊代碼、整合第三方庫時的「降噪耳機」。**善用它們,讓編譯器輸出的信號雜訊比最大化**,專注於真正影響正確性的警告。