C# JSON序列化与反序列化 - System.Text.Json与Newtonsoft.Json对比

System.Text.Json性能更高、更省内存，适合高性能场景；Newtonsoft.Json功能更丰富、兼容性更好，适合复杂定制需求；新项目推荐System.Text.Json，旧项目可继续使用Newtonsoft.Json。

在C#开发中，处理JSON数据是常见需求，尤其是在Web API、配置读取和跨服务通信场景下。目前主流的两个JSON库是 System.Text.Json 和 Newtonsoft.Json（又称Json.NET）。两者都能完成序列化与反序列化任务，但在性能、功能、兼容性和使用方式上存在差异。

1. 性能对比：System.Text.Json 更快更省内存

System.Text.Json 是 .NET Core 3.0 引入的原生 JSON 库，由微软团队专门优化，底层基于 Span 和只读字符序列，避免频繁分配内存，因此在大多数场景下比 Newtonsoft.Json 更快。

• 序列化大型对象时，System.Text.Json 通常有更高的吞吐量
• 反序列化字符串或流数据时，内存分配更少，GC 压力更低
• 尤其适合高性能 Web API 返回 JSON 响应的场景

如果你追求极致性能且不需要复杂功能，优先选择 System.Text.Json。

2. 功能丰富度：Newtonsoft.Json 更灵活强大

Newtonsoft.Json 发布多年，生态成熟，支持更多高级特性：

• 支持字段、私有成员、动态类型（JObject、JArray）操作
• 丰富的属性控制：如条件序列化（ShouldSerializeXXX）、自定义转换器（JsonConverter）粒度更细
• 支持 LINQ to JSON，可在运行时查询和修改 JSON 结构
• 更好的错误处理机制和调试支持
• 兼容老版本 .NET Framework，适合旧项目维护

对于需要深度定制序列化行为、处理非标准 JSON 或与第三方接口对接的复杂场景，Newtonsoft.Json 仍是首选。

3. 使用方式对比：API 设计风格不同

两者基本用法相似，但命名和配置方式略有区别。

System.Text.Json 示例：

var options = new JsonSerializerOptions
{
    PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
    WriteIndented = true
};
var json = JsonSerializer.Serialize(person, options);
var personObj = JsonSerializer.Deserialize(json, options);

Newtonsoft.Json 示例：

var settings = new JsonSerializerSettings
{
    ContractResolver = new CamelCasePropertyNamesContractResolver(),
    Formatting = Formatting.Indented
};
var json = JsonConvert.SerializeObject(person, settings);
var personObj = JsonConvert.DeserializeObject(json, settings);

注意：默认情况下，System.Text.Json 只序列化 public 属性，不支持字段；而 Newtonsoft.Json 可通过特性或设置控制字段访问级别。

4. 兼容性与迁移建议

从 .NET 5 开始，ASP.NET Core 默认使用 System.Text.Json 作为后台序列化引擎。但如果你的项目依赖以下情况，可能仍需保留 Newtonsoft.Json：

• 使用了大量自定义 JsonConverter
• 需要反序列化包含类型信息的 JSON（如 "$type" 字段）
• 依赖 JsonPropertyAttribute 的高级选项（如命名映射、默认值处理等）
• 正在维护旧系统且迁移成本高

好消息是，Microsoft 提供了 Microsoft.AspNetCore.Mvc.NewtonsoftJson 包，允许在 ASP.NET Core 中继续使用 Newtonsoft.Json 作为 MVC 的序列化器。

基本上就这些。选择哪个库取决于你的具体需求：要性能和现代性选 System.Text.Json，要灵活性和兼容性选 Newtonsoft.Json。现在很多新项目采用 System.Text.Json 为主，必要时通过中间层兼容旧逻辑。不复杂但容易忽略的是日期格式、null 处理和循环引用这些细节，不同库默认行为不一样，需显式配置以避免意外。