CodeGym /課程 /C# SELF /在專案中啟用與設定 Nullable Reference Types (NRT)

在專案中啟用與設定 Nullable Reference Types (NRT)

C# SELF
等級 14, 課堂 2
開放

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>
.csproj 檔案啟用 NRT 的範例

如果你看到 <Nullable>disable</Nullable>,就代表 NRT 檢查是關閉的。

2. 怎麼啟用 NRT 模式

透過 .csproj——整個專案一起開

  1. 打開(或新建).csproj 檔案。
  2. 在 <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> 裡還能設什麼?

值 行為
enable
全部開啟:註解和警告都會有
disable
完全關閉 null 參考分析
warnings
只有警告,不強制註解
annotations
需要註解,但編譯器不會警告
restore
回復到原本(像是全域設定)的行為

通常大家用 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。
2
任務
C# SELF, 等級 14, 課堂 2
上鎖
檢查 Nullable Reference Types 在方法裡的使用情況
檢查 Nullable Reference Types 在方法裡的使用情況
2
任務
C# SELF, 等級 14, 課堂 2
上鎖
部分啟用 Nullable Reference Types
部分啟用 Nullable Reference Types
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION