在實際的企業開發環境中，尤其是內網隔離環境，開發人員經常面臨無法使用 NuGet 安裝外部包的問題。對于基于 .NET Framework 4.8 的應用，JSON 解析是一個常見的需求，但初始項目中往往未包含任何 JSON 處理相關的程序集。這時，了解如何手動添加系統擴展組件顯得尤為關鍵。

本文將詳細講解如何在不依賴 NuGet 的情況下，引入 System.Text.Json 進行 JSON 數據的處理。

?

---

一、問題背景：無法使用 NuGet 獲取 JSON 庫

在 .NET Framework 4.8 環境下，很多開發者習慣使用 Newtonsoft.Json 來進行 JSON 解析。但在內網環境中，訪問 NuGet 非常不便，甚至完全無法下載外部庫。

這種情況下，開發者只能依賴系統自帶的組件來完成相關功能，而 System.Text.Json 是一個性能優異的替代方案。

---

二、解決方案：使用“引用管理器”引入系統擴展組件

為解決 JSON 序列化/反序列化問題，我們可以利用 Visual Studio 自帶的“引用管理器”，手動添加系統級的 JSON 處理程序集。

步驟如下：

1. 在 Visual Studio 的“解決方案資源管理器”中，右擊你的項目節點；

2. 選擇“添加” -> “引用”；

3. 在彈出的“引用管理器”窗口中，左側選擇“程序集” -> “擴展”；

4. 找到并勾選 System.Text.Json；

5. 點擊“確定”以完成添加。

此時，項目中就可以使用該程序集中的相關功能了。

---

三、使用示例：基本的 JSON 序列化和反序列化

引入 System.Text.Json 后，我們可以立即進行 JSON 數據處理。以下是一個簡單示例：

using System;
using System.Text.Json;public class Person {public string Name { get; set; }public int Age { get; set; }
}class Program {static void Main() {// 創建對象并序列化var person = new Person { Name = "張三", Age = 30 };string json = JsonSerializer.Serialize(person);Console.WriteLine("JSON 輸出: " + json);// 反序列化回對象var deserialized = JsonSerializer.Deserialize<Person>(json);Console.WriteLine($"姓名: {deserialized.Name}, 年齡: {deserialized.Age}");}
}

該示例展示了如何將對象轉為 JSON 字符串，并從 JSON 字符串反解析回對象。

---

四、適用范圍與注意事項

• System.Text.Json 是 .NET Core 3.0+ 和 .NET Framework 4.7.2+ 的一部分，確保目標環境具備必要依賴；

• 如果項目無法找到此程序集，建議安裝 .NET Framework Developer Pack（包含最新 SDK 和參考程序集）；

• System.Text.Json 不完全兼容 Newtonsoft.Json，某些高級特性（如復雜數據類型、DataTable 處理）可能需額外實現。

---

總結

在內網開發場景下，無法訪問 NuGet 時，仍可通過添加 System.Text.Json 程序集實現 JSON 數據的解析和生成。這種方式簡便高效，適合絕大多數企業開發環境中的 JSON 操作需求。