【C#】System.Text.Json

System.Text.Json 是 .NET Core 3.0 及更高版本中引入的一个高性能的、低内存的 JSON 序列化与反序列化库。它是 .NET Core 和 .NET 5/6/7 等新版本中推荐的 JSON 处理方式，因为它比旧的 Newtonsoft.Json（通常称为 Json.NET）库在性能上有所提升，并且它是 Microsoft 官方维护的。

主要特点

• 高性能：System.Text.Json 通过使用 UTF-8 编码和最小化内存分配来提高性能。
• 低内存占用：设计用于最小化内存分配和复制操作，减少垃圾回收的压力。
• 安全性：默认行为更加安全，比如不会无限深地反序列化 JSON，以防止潜在的拒绝服务攻击。
• 内置支持：作为 .NET Core 和 .NET 5/6/7 等新版本的一部分，无需额外安装 NuGet 包。
• 灵活性：尽管默认行为较为严格，但提供了自定义序列化和反序列化的选项，包括自定义属性命名、处理枚举、处理多态类型等。

使用场景

• 序列化：将 .NET 对象转换为 JSON 格式的字符串。
• 反序列化：将 JSON 格式的字符串转换回 .NET 对象。

基本用法

序列化

using System;
using System.Text.Json;public class WeatherForecast
{public DateTime Date { get; set; }public int TemperatureCelsius { get; set; }public string Summary { get; set; }
}public class Program
{public static void Main(){var weatherForecast = new WeatherForecast{Date = DateTime.Parse("2019-08-01"),TemperatureCelsius = 25,Summary = "Hot"};string jsonString = JsonSerializer.Serialize(weatherForecast);Console.WriteLine(jsonString);}
}

反序列化

using System;
using System.Text.Json;// 假设 jsonString 是从某处获取的 JSON 字符串
string jsonString = "{\"Date\":\"2019-08-01T00:00:00\",\"TemperatureCelsius\":25,\"Summary\":\"Hot\"}";WeatherForecast weatherForecast = JsonSerializer.Deserialize<WeatherForecast>(jsonString);Console.WriteLine($"Date: {weatherForecast.Date}, TemperatureCelsius: {weatherForecast.TemperatureCelsius}, Summary: {weatherForecast.Summary}");

自定义序列化与反序列化

System.Text.Json 允许通过继承 JsonConverter<T> 类来自定义序列化和反序列化过程。这对于处理复杂类型、自定义类型或需要非标准 JSON 结构的场景特别有用。

注意事项

• System.Text.Json 在处理 JSON 时默认是大小写敏感的，而 Newtonsoft.Json 不是。
• System.Text.Json 在某些情况下可能不如 Newtonsoft.Json 灵活（比如处理多态类型时），但它提供了足够的自定义选项来满足大多数需求。
• 考虑到性能和内存使用，推荐在可能的情况下使用 System.Text.Json。如果现有项目已经大量使用 Newtonsoft.Json 并且迁移成本较高，可以继续使用它。