在現(xiàn)代軟件開發(fā)中，JSON（JavaScript Object Notation）已成為數(shù)據(jù)交換的事實標(biāo)準(zhǔn)。無論是與 Web API 通信、配置文件管理，還是微服務(wù)間的消息傳遞，JSON 都無處不在。C# 作為一門強類型語言，提供了豐富而成熟的 JSON 處理能力。本文將系統(tǒng)性地介紹 C# 中 JSON 序列化與反序列化的核心概念、主流方案、設(shè)計哲學(xué)以及工程實踐中的關(guān)鍵考量。

一、序列化與反序列化的本質(zhì)

在深入技術(shù)細(xì)節(jié)之前，有必要先厘清這兩個核心概念：

• 序列化（Serialization） 是指將內(nèi)存中的對象狀態(tài)轉(zhuǎn)換為可存儲或可傳輸格式的過程。在 JSON 語境下，就是將 C# 對象圖轉(zhuǎn)換為符合 JSON 規(guī)范的字符串。
• 反序列化（Deserialization） 則是其逆過程：將 JSON 字符串重新構(gòu)建為內(nèi)存中的 C# 對象實例。

這一過程看似簡單，實則涉及類型系統(tǒng)映射、引用關(guān)系處理、循環(huán)依賴檢測、數(shù)據(jù)驗證等復(fù)雜問題。理解這一點，有助于我們在遇到異常行為時快速定位根因。

二、C# 中的兩大主流方案

.NET 生態(tài)中，JSON 處理經(jīng)歷了從第三方庫到官方內(nèi)置方案的演進(jìn)，形成了當(dāng)前雙雄并立的格局。

1. Newtonsoft.Json（Json.NET）

作為 .NET 領(lǐng)域歷史最悠久、功能最豐富的 JSON 庫，Newtonsoft.Json 由 James Newton-King 開發(fā)，長期以來一直是行業(yè)標(biāo)準(zhǔn)。其特點包括：

• 極致的靈活性：幾乎支持任何復(fù)雜的序列化場景，包括自定義轉(zhuǎn)換器、引用保留、類型信息嵌入等高級功能。
• 豐富的配置選項：通過 JsonSerializerSettings 可以精細(xì)控制格式化行為、空值處理、日期格式、命名策略等。
• 廣泛的兼容性：支持從 .NET Framework 2.0 到現(xiàn)代 .NET 的全版本覆蓋，擁有龐大的社區(qū)生態(tài)和文檔積累。

在 .NET Core 3.0 之前，Newtonsoft.Json 幾乎是每個項目的標(biāo)配依賴。

2. System.Text.Json

隨著 .NET Core 3.0 的發(fā)布，微軟推出了官方內(nèi)置的高性能 JSON 庫 System.Text.Json。其設(shè)計目標(biāo)非常明確：

• 性能優(yōu)先：基于 Span 和 UTF-8 直接處理，避免了大量字符串分配，在吞吐量和內(nèi)存占用上顯著優(yōu)于 Newtonsoft.Json。
• 原生集成：無需額外 NuGet 包，與 .NET 框架深度整合，特別是在 ASP.NET Core 中作為默認(rèn)序列化器。
• 安全性：默認(rèn)啟用嚴(yán)格模式，對深度嵌套、數(shù)字范圍等有內(nèi)置保護(hù)機制。

然而，早期版本的 System.Text.Json 在功能豐富度上不及 Newtonsoft.Json。經(jīng)過 .NET 5、6、7、8 的持續(xù)迭代，目前已覆蓋絕大多數(shù)常見場景，但在處理高度動態(tài)化或遺留系統(tǒng)兼容時，仍可能需要借助 Newtonsoft.Json 的靈活性。

三、核心機制與配置哲學(xué)

無論選擇哪種方案，理解其配置哲學(xué)都是高效使用的前提。

1. 命名策略（Naming Policy）

C# 遵循 PascalCase 命名規(guī)范（如 UserName），而 JSON 生態(tài)中更常見 camelCase（如 userName）或 snake_case（如 user_name）。序列化庫通常提供全局或局部的命名策略配置，以確保兩端命名風(fēng)格的無縫映射。

2. 空值處理

對于可空屬性，需要決定序列化時是否包含空值字段。包含空值會增加傳輸體積，但有助于保持結(jié)構(gòu)完整性；忽略空值則能減少數(shù)據(jù)量，但可能導(dǎo)致接收方無法區(qū)分"未設(shè)置"和"設(shè)置為 null"。

3. 日期與時間處理

JSON 標(biāo)準(zhǔn)并未定義日期格式，實踐中通常采用 ISO 8601 格式（如 2026-05-21T08:50:00Z）。處理時區(qū)、本地時間與 UTC 時間的轉(zhuǎn)換，以及高精度時間戳的支持，都是配置中需要關(guān)注的要點。

4. 循環(huán)引用與對象圖

當(dāng)對象間存在雙向引用（如父子節(jié)點互相引用）時，簡單的序列化會導(dǎo)致無限遞歸。成熟的庫提供兩種解決路徑：一是忽略循環(huán)引用（可能丟失數(shù)據(jù)），二是通過引用標(biāo)識符（id、id、id、ref）保留對象圖的完整性。

5. 多態(tài)類型處理

在面向?qū)ο笤O(shè)計中，基類引用指向派生類實例是常見模式。序列化時需要決定是否包含類型信息，以便反序列化時準(zhǔn)確重建對象類型。這通常通過類型判別器（Discriminator）或全類型名稱嵌入實現(xiàn)。

四、自定義行為與擴展點

實際項目中，自動映射往往無法滿足所有需求。兩種方案都提供了強大的擴展機制。

1. 自定義轉(zhuǎn)換器（JsonConverter）

當(dāng)標(biāo)準(zhǔn)映射規(guī)則不適用時（如特殊格式字符串、復(fù)雜枚舉、加密字段），可以編寫自定義轉(zhuǎn)換器。轉(zhuǎn)換器允許你完全控制特定類型的讀寫邏輯，實現(xiàn)業(yè)務(wù)層面的精確映射。

2. 屬性注解（Attributes）

通過在模型屬性上添加注解，可以局部覆蓋全局配置。常見用途包括：

• 指定 JSON 中的字段名稱（如將 C# 的 IPAddress 映射為 JSON 的 ip_address）
• 控制字段的序列化/反序列化可見性
• 設(shè)置日期格式、數(shù)值精度等
• 標(biāo)記必填字段或忽略特定屬性

3. 契約解析器（Contract Resolver）

在 Newtonsoft.Json 中，契約解析器提供了更底層的控制，允許通過編程方式動態(tài)決定序列化行為，而無需修改模型類本身。這在無法注解第三方類或需要運行時動態(tài)策略時特別有用。

五、基于Newtonsoft.Json庫代碼實現(xiàn)

public class JsonUtils
{
    /// <summary>
    /// 將對象轉(zhuǎn)換成Json文件
    /// </summary>
    /// <param name="obj">類對象參數(shù)</param>
    /// <param name="jsonFile">Json文件完整路徑</param>
    /// <returns></returns>
    public static bool ToJsonFile(object obj, string jsonFile)
    {
        if (obj != null)
        {
            string json = JsonConvert.SerializeObject(obj);
            File.WriteAllText(jsonFile, json);
            return true;
        }
        return false;
    }

    /// <summary>
    /// 從Json文件反序列化
    /// </summary>
    /// <typeparam name="T">泛型類</typeparam>
    /// <param name="jsonFile">Json文件完整路徑</param>
    /// <returns></returns>
    public static T? FromJsonFile<T>(string jsonFile)
    {
        if (File.Exists(jsonFile))
        {
            string json = File.ReadAllText(jsonFile);
            T? jsonObj = JsonConvert.DeserializeObject<T>(json);
            return jsonObj;
        }
        return default;
    }

    /// <summary>
    /// 將對象序列化Json字符串
    /// </summary>
    /// <param name="obj"></param>
    /// <returns></returns>
    public static string ToJson(object? obj)
    {
        if (obj != null)
        {
            string json = JsonConvert.SerializeObject(obj);
            return json;
        }
        return string.Empty;
    }

    /// <summary>
    /// 將Json字符串反序列化為對象
    /// </summary>
    /// <typeparam name="T">泛型類</typeparam>
    /// <param name="json">Json字符串</param>
    /// <returns></returns>
    public static T? FromJson<T>(string? json)
    {
        if (!string.IsNullOrEmpty(json))
        {
            T? jsonObj = JsonConvert.DeserializeObject<T>(json);
            return jsonObj;
        }
        return default;
    }
}

六、性能考量與選型建議

性能差異是兩種方案最顯著的區(qū)別之一。System.Text.Json 在設(shè)計上充分利用了現(xiàn)代 .NET 的內(nèi)存管理優(yōu)化，特別適合高吞吐量場景，如微服務(wù)網(wǎng)關(guān)、高頻 API 接口、實時數(shù)據(jù)流處理。
然而，性能并非唯一指標(biāo)。在以下場景，Newtonsoft.Json 仍是更穩(wěn)妥的選擇：

• 需要處理高度動態(tài)的數(shù)據(jù)（如 JObject、JToken 的靈活操作）
• 遺留系統(tǒng)的深度集成，依賴其特有的序列化特性
• 復(fù)雜的繼承層次結(jié)構(gòu)需要精確的類型信息保留
• 項目中已大量使用其高級功能，遷移成本過高

對于新項目，建議優(yōu)先評估 System.Text.Json 是否滿足需求；若功能缺口不大，其原生集成和性能優(yōu)勢值得采用。若遇到邊界情況，兩者也可以共存——.NET 允許在不同場景下分別使用不同的序列化器。

七、反序列化的安全與健壯性

反序列化是不可信數(shù)據(jù)進(jìn)入系統(tǒng)的關(guān)鍵入口，必須謹(jǐn)慎處理。

1. 類型安全

反序列化到強類型對象是最安全的做法，因為類型系統(tǒng)會自然過濾不兼容數(shù)據(jù)。若必須使用弱類型（如 JsonElement 或 JToken），務(wù)必在訪問時進(jìn)行顯式類型檢查和轉(zhuǎn)換。

2. 深度與大小限制

惡意構(gòu)造的 JSON（如深度嵌套對象、超大字符串）可能導(dǎo)致棧溢出或內(nèi)存耗盡。生產(chǎn)環(huán)境應(yīng)配置最大深度、字符串長度和緩沖區(qū)大小限制。

3. 數(shù)字范圍檢查

JSON 數(shù)字沒有顯式類型邊界，反序列化到 C# 數(shù)值類型時可能發(fā)生溢出。應(yīng)在模型中使用合適范圍的類型，或在反序列化后手動驗證。

八、總結(jié)

C# 的 JSON 處理能力經(jīng)過十余年發(fā)展，已形成成熟且多元的解決方案。System.Text.Json 代表了官方的高性能、現(xiàn)代化方向，而 Newtonsoft.Json 憑借其無與倫比的靈活性仍在復(fù)雜場景中占據(jù)重要地位。

作為開發(fā)者，理解兩者的設(shè)計哲學(xué)差異，根據(jù)項目實際需求做出選型，并在序列化契約設(shè)計中兼顧性能、安全與可維護(hù)性，是構(gòu)建健壯系統(tǒng)的關(guān)鍵。JSON 序列化看似只是"對象轉(zhuǎn)字符串"的簡單操作，但其背后涉及的類型系統(tǒng)、內(nèi)存管理和安全考量，正是工程化思維的最佳體現(xiàn)。

以上就是C# JSON序列化與反序列化的最佳實踐的詳細(xì)內(nèi)容，更多關(guān)于C# JSON序列化與反序列化的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論