C# 中常见 JSON 处理库的优缺点对比

以下是 C# 中常见 JSON 库的对比（包括 Newtonsoft.Json、System.Text.Json、Utf8Json、Jil、ServiceStack.Text），并附上等效的序列化/反序列化代码示例。

---

1. Newtonsoft.Json (Json.NET)

• 特点

  • 功能最全面，支持动态类型、多态序列化、循环引用等复杂场景。
  • 灵活的配置选项（如忽略空值、自定义转换器）。
  • 性能中等，适用于大多数通用场景。

• 代码示例

  // 序列化
  var obj = new { Name = "Alice", Age = 30 };
  string json = JsonConvert.SerializeObject(obj, new JsonSerializerSettings
  {
      NullValueHandling = NullValueHandling.Ignore,
      Formatting = Formatting.Indented
  });
  
  // 反序列化
  var result = JsonConvert.DeserializeObject<MyClass>(json);
  

---

2. System.Text.Json (官方库)

• 特点

  • 高性能（基于 Span 和 Utf8JsonReader/Writer）。
  • 内存占用低，适合高并发场景。
  • 功能逐步完善（.NET 7+ 支持更多特性如多态序列化）。

• 代码示例

  // 序列化
  var obj = new MyClass { Name = "Alice", Age = 30 };
  string json = JsonSerializer.Serialize(obj, new JsonSerializerOptions
  {
      WriteIndented = true,
      DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
      PropertyNamingPolicy = JsonNamingPolicy.CamelCase
  });
  
  // 反序列化
  var result = JsonSerializer.Deserialize<MyClass>(json);
  

---

3. Utf8Json

• 特点

  • 极高性能（基于零分配和预编译IL生成）。
  • 支持异步流式处理。
  • 需要预生成代码或手动编写解析逻辑。

• 代码示例

  // 安装 NuGet 包 Utf8Json
  [DataContract]
  public class MyClass
  {
      [DataMember(Name = "name")]
      public string Name { get; set; }
      [DataMember(Name = "age")]
      public int Age { get; set; }
  }
  
  // 序列化
  byte[] jsonBytes = Utf8Json.JsonSerializer.Serialize(obj);
  string json = Encoding.UTF8.GetString(jsonBytes);
  
  // 反序列化
  var result = Utf8Json.JsonSerializer.Deserialize<MyClass>(jsonBytes);
  

---

4. Jil

• 特点

  • 高性能（基于动态方法生成）。
  • 配置简单，但功能较少（不支持复杂类型如动态对象）。
  • 适合严格的静态类型场景。

• 代码示例

  // 安装 NuGet 包 Jil
  var obj = new MyClass { Name = "Alice", Age = 30 };
  
  // 序列化
  string json = Jil.JSON.Serialize(obj, Options.CamelCase);
  
  // 反序列化
  var result = Jil.JSON.Deserialize<MyClass>(json);
  

---

5. ServiceStack.Text

• 特点

  • 高性能，支持多种数据格式（JSON、CSV等）。
  • 配置灵活，支持自定义序列化规则。
  • 部分功能需商业许可。

• 代码示例

  // 安装 NuGet 包 ServiceStack.Text
  var obj = new MyClass { Name = "Alice", Age = 30 };
  
  // 序列化
  string json = ServiceStack.Text.JsonSerializer.SerializeToString(obj);
  
  // 反序列化
  var result = ServiceStack.Text.JsonSerializer.DeserializeFromString<MyClass>(json);
  

---

对比总结

库	性能	功能丰富性	易用性	适用场景
Newtonsoft.Json	中	最全面	高	复杂类型、旧项目维护
System.Text.Json	高	中等（逐步增强）	中等	新项目、高性能需求
Utf8Json	极高	低	低	极致性能、流式处理
Jil	高	低	高	简单静态类型、快速序列化
ServiceStack.Text	高	中等	中等	多格式支持、商业项目（需许可）

---

等效代码对比（序列化忽略空值）

1. Newtonsoft.Json

   JsonConvert.SerializeObject(obj, new JsonSerializerSettings 
   { 
       NullValueHandling = NullValueHandling.Ignore 
   });
   

2. System.Text.Json

   JsonSerializer.Serialize(obj, new JsonSerializerOptions 
   { 
       DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull 
   });
   

3. Utf8Json

   // 需手动标记属性或自定义解析器
   [DataMember(EmitDefaultValue = false)]
   public string Name { get; set; }
   

4. Jil

   JSON.Serialize(obj, Options.IncludeInherited); // 不支持直接忽略空值
   

---

选择建议

• 优先 System.Text.Json：新项目、性能敏感、减少依赖。
• Newtonsoft.Json：需要动态类型或复杂序列化逻辑。
• Utf8Json/Jil：追求极限性能（需权衡功能缺失）。
• ServiceStack.Text：多格式处理或已有项目迁移。

根据实际需求权衡性能、功能和开发效率！