C#中解析jsON最常用的是Newtonsoft.json,它比System.Text.Json更灵活,支持复杂嵌套、自定义序列化等;需通过NuGet安装并引用using Newtonsoft.Json;,可用JObject动态解析或DeserializeObject反序列化为强类型对象,注意大小写匹配、空值处理和日期格式。

在C#中解析JSON字符串,最常用、最成熟的方式是使用 Newtonsoft.Json(也叫 Json.net)。它支持复杂嵌套、日期格式、自定义序列化等,比 .NET 原生的 System.Text.Json 更灵活(尤其在老项目或需要精细控制时)。
安装 Newtonsoft.Json
通过 NuGet 安装(推荐):
- visual studio:右键项目 → “管理 NuGet 包” → 搜索 Newtonsoft.Json → 安装
- 命令行(Package Manager console):
Install-Package Newtonsoft.Json - .NET CLI:
dotnet add package Newtonsoft.Json
安装完成后,在代码顶部加引用:
using Newtonsoft.Json;
快速解析简单 JSON 字符串
比如有这段 JSON:
String json = @”{“”name””:””张三””,””age””:25,””isStudent””:true}”;
你可以直接反序列化为匿名对象或具体类:
- 用
JObject动态解析(适合结构不确定或临时读取):
JObject obj = JObject.Parse(json);
string name = (string)obj[“name”]; // 张三
int age = (int)obj[“age”]; // 25 - 反序列化为强类型对象(推荐用于已知结构):
var person = JsonConvert.DeserializeObject(json);
Console.WriteLine(person.Name); // 张三
需要先定义类:
public class Person { public string Name { get; set; }
public int Age { get; set; }
public bool IsStudent { get; set; } }
处理数组和嵌套对象
JSON 含数组或子对象时,类属性对应声明即可:
string json = @”{“”title””:””课程表””,””items””:[{“”id””:1,””name””:””数学””},{“”id””:2,””name””:””英语””}]}”;
定义匹配类:
public class Schedule { public string Title { get; set; }
public List
public class Item { public int Id { get; set; } public string Name { get; set; } }
然后解析:
var schedule = JsonConvert.DeserializeObject
常见注意事项
- JSON 属性名默认区分大小写,C# 类属性名不匹配时可用
[JsonProperty("xxx")]标记,例如:
[JsonProperty(“user_name”)] public string UserName { get; set; } - 空值或缺失字段:属性设为可空类型(如
int?、string默认可空),或用NullValueHandling.Ignore控制序列化行为 - 日期格式:Newtonsoft 默认识别 ISO 8601(如
"2023-05-10T08:30:00"),也可自定义DateTimeZoneHandling - 异常处理:务必用
try-catch包裹Parse或DeserializeObject,避免非法 JSON 导致崩溃
基本上就这些。Newtonsoft.Json 上手快、文档全、社区支持好,中小型项目用它解析 JSON 几乎零门槛。不复杂但容易忽略细节,比如大小写、空值、日期——盯住这三点,基本不会踩坑。