1. 前言
為什麼 NRT 需要另外啟用?
Nullable Reference Types (NRT) 不是單純的語法糖,而是編譯器對抗 null 相關 bug 的強力助手。但因為歷史原因,這個模式在舊專案裡預設是關閉的——避免破壞相容性。如果你用最新版 .NET(像是 .NET 7、8 或 9)新建專案,NRT 通常會自動啟用。但如果你的專案比較舊,或你想手動控制這個模式,就要自己設定囉。
Nullable Reference Types 模式到底做了什麼?
當這個模式啟用時,編譯器會分析哪些參考型別變數可能是 null,哪些不是。它不會影響程式執行,但只要發現可能的問題就會給你警告。這是寫出可靠、易懂又穩定程式碼的好方法。
怎麼知道 NRT 模式有沒有開?
如果你是 .NET 6 或更新版的新專案,NRT 大概已經開了。但還是建議檢查一下!
- 打開專案檔案,通常副檔名是 .csproj。
- 找到或新增 <Nullable> 設定在第一個 <PropertyGroup> 標籤裡面。
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
<Nullable>enable</Nullable>
</PropertyGroup>
</Project>
如果你看到 <Nullable>disable</Nullable>,就代表 NRT 檢查是關閉的。
2. 怎麼啟用 NRT 模式
透過 .csproj——整個專案一起開
- 打開(或新建).csproj 檔案。
- 在 <PropertyGroup> 區塊裡加上或修改這一行:
<Nullable>enable</Nullable>
這樣編譯器就會幫你盯著專案裡所有 .cs 檔案,遇到可能危險的 null 用法就會警告你。
為什麼要這樣做?
因為這是全域設定。從現在開始,整個專案都要遵守新規則:null 都是嫌疑犯,馬虎不得!
只針對特定檔案或程式區塊
如果你還沒準備好讓整個專案都變嚴格,可以先在部分檔案練習。這時可以用前處理指令:
#nullable enable
string? value = null; // 這裡有開分析
#nullable disable
string legacyValue = null; // 這裡就沒開
#nullable restore
- #nullable enable —— 開啟檢查直到檔案結尾。
- #nullable disable —— 關閉檢查。
- #nullable restore —— 回復 .csproj 或外部檔案的設定。
這樣很方便:你可以在新模組開嚴格檢查,舊的、不穩定的程式碼就先不要動。
在 <Nullable> 裡還能設什麼?
| 值 | 行為 |
|---|---|
|
全部開啟:註解和警告都會有 |
|
完全關閉 null 參考分析 |
|
只有警告,不強制註解 |
|
需要註解,但編譯器不會警告 |
|
回復到原本(像是全域設定)的行為 |
通常大家用 enable 或 disable。
3. 範例示範
NRT 開啟前
// 舊模式,NRT 沒開
string s = null; // 不會有抱怨
Console.WriteLine(s.Length); // 危險! 可能會 NullReferenceException
NRT 開啟後
// 新模式,NRT 有開
string s = null; // 警告: 可能賦值 null
Console.WriteLine(s.Length); // 警告: 可能存取到 null
這時 IDE 會開始標記潛在問題,編譯器也會提醒你:Dereference of a possibly null reference. (CS8602)
怎麼修正?
string? s = null;
if (s != null)
{
Console.WriteLine(s.Length);
}
這樣你就明確告訴編譯器:這個變數可能是 null,編譯器就不會再唸你了。
4. 如果專案是「舊式寫法」怎麼辦?
很多專案都是在 null 幾乎每個參考型別變數都會出現的年代寫的。開啟 NRT,就像請了一個嚴格的稽核員,會告訴你每一個潛在問題。
如果警告太多怎麼辦?
別緊張——這些只是提示,不是錯誤。程式還是可以編譯。
- 你可以只在新檔案開 NRT。
- 慢慢整理程式碼:加上 ?,做 null 檢查,用 !(這個之後會講)。
- 記住:你越小心處理 null,以後問題就越少。
相容性與第三方函式庫
- 開啟 NRT 不會改變執行時的程式行為,只是在編譯時多一層分析。
- 舊程式碼可能會馬上出現一堆警告。
- 如果你用的函式庫沒有 NRT 註解,編譯器會很保守,假設所有東西都可能是 null。
GO TO FULL VERSION