C#如何反序列化JSON C#将JSON字符串转换为对象的方法

月夜之吻 2025-11-23 00:00:00 次阅读

答案是使用 System.Text.Json 或 Newtonsoft.Json 将 JSON 字符串反序列化为 C# 对象。首先定义属性匹配的类，然后调用 JsonSerializer.Deserialize 或 JsonConvert.DeserializeObject 方法解析字符串，支持嵌套结构与自定义字段映射，推荐 .NET 6+ 项目优先使用 System.Text.Json 以获得更好性能。

在C#中，将JSON字符串转换为对象的过程称为反序列化。最常用的方式是使用 System.Text.Json（.NET Core 3.0+ 默认推荐）或第三方库如 Newtonsoft.Json（又称 Json.NET）。以下是两种主流方法的详细说明。

使用 System.Text.Json 反序列化 JSON

System.Text.Json 是 .NET 内置的高性能 JSON 操作库，适用于大多数现代 C# 项目。

示例代码：

using System;
using System.Text.Json;
// 定义目标类
public class Person
{
public string Name { get; set; }
public int Age { get; set; }
}
// JSON 字符串
string jsonString = @"{""Name"": ""张三"", ""Age"": 30}";
// 反序列化
Person person = JsonSerializer.Deserialize(jsonString);
Console.WriteLine(person.Name); // 输出：张三
Console.WriteLine(person.Age);  // 输出：30

注意：

属性名默认需与 JSON 字段匹配（大小写敏感）。
可使用 [JsonPropertyName] 特性自定义映射。

使用 Newtonsoft.Json 反序列化 JSON

Newtonsoft.Json 功能更灵活，支持老版本 .NET Framework，广泛用于现有项目。

安装 NuGet 包：

Install-Package Newtonsoft.Json

示例代码：

using Newtonsoft.Json;
string jsonString = @"{""Name"": ""李四"", ""Age"": 25}";
Person person = JsonConvert.DeserializeObject(jsonString);
Console.WriteLine(person.Name); // 输出：李四

特性支持：

使用 [JsonProperty("xxx")] 指定字段名。
支持复杂类型、日期格式、空值处理等高级配置。

处理嵌套对象和数组

无论是 System.Text.Json 还是 Newtonsoft.Json，都可以自动处理嵌套结构。

public class Address
{
    public string City { get; set; }
    public string Street { get; set; }
}
public class Person
{
public string Name { get; set; }
public Address HomeAddress { get; set; }
}
string json = @"{
""Name"": ""王五"",
""HomeAddress"": {
""City"": ""北京"",
""Street"": ""朝阳路123号""
}
}";
Person p = JsonSerializer.Deserialize(json);
Console.WriteLine(p.HomeAddress.City); // 输出：北京