c#如何反序列化JSON_c#反序列化JSON的几种常见写法-C#.Net教程-PHP中文网

最推荐.NET Core 3.0+用System.Text.Json，性能好、内存低、原生支持；注意异常类型、命名策略、集合类型限制及类型兼容性问题。

c#如何反序列化json_c#反序列化json的几种常见写法

.NET Core 3.0+ 默认推荐用 System.Text.Json，性能好、内存占用低、原生支持。它不依赖第三方包，只要项目是 .NET 5+ 或启用了 System.Text.Json 的 .NET Core 3.1+ 就能直接用。

常见错误：传入 null 字符串或格式非法 JSON 时，JsonSerializer.Deserialize() 会直接抛 JsonException，不是 NullReferenceException —— 别错判异常类型。

基础写法：var obj = JsonSerializer.Deserialize("{\"Name\":\"Alice\"}");
从文件读取建议用 DeserializeAsync 配合 FileStream，避免一次性加载大 JSON 到内存
若 JSON 字段名和 C# 属性名不一致（比如 JSON 是 user_name，C# 是 UserName），加 [JsonPropertyName("user_name")] 特性，别依赖 DefaultIgnoreCondition 来“猜”映射
反序列化数组或集合时，目标类型必须是具体泛型类型（如 List），不能是 IEnumerable —— 否则运行时报错 NotSupportedException

如果你维护的是 .NET Framework 项目，或需要处理 DateTime 格式混乱、循环引用、JObject 动态解析等场景，Newtonsoft.Json 仍是更灵活的选择。

注意：NuGet 包名是 Newtonsoft.Json，不是 Json.NET；安装后记得加 using Newtonsoft.Json;，否则 JsonConvert.DeserializeObject 找不到。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

基础写法：var obj = JsonConvert.DeserializeObject("{\"name\":\"Bob\"}");
时间字段容易出问题：默认把 "2023-01-01" 当成本地时间反序列化，建议显式配置 JsonSerializerSettings.DateFormatHandling = DateFormatHandling.IsoDateFormat
遇到 Cannot deserialize the current JSON array 错误，大概率是传了 JSON 数组但目标类型写了单个对象（比如用了 DeserializeObject 却传了 [{"id":1}]）
动态解析用 JObject.Parse(json) 或 JArray.Parse(json)，比强类型反序列化慢，但适合结构不确定的 API 响应

报错信息里带 LineNumber 和 BytePositionInLine 的，基本是 JSON 语法错误（多逗号、少引号、中文引号）；没这些信息的，往往是类型不匹配或属性不可写。

先用在线工具（如 jsonlint.com）校验 JSON 合法性，排除格式问题
检查目标类所有属性是否为 public 且有 getter/setter —— private set 可以，但 readonly 字段或只读自动属性（public string Name { get; }）无法赋值
如果 JSON 里有数字字段，但 C# 属性是 string，System.Text.Json 默认不自动转换（会报 JsonException: The JSON value could not be converted），得配 JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()) 类似逻辑，或自定义 JsonConverter
调试时临时改成反序列化为 JsonDocument（System.Text.Json）或 JToken（Newtonsoft），再逐层查字段是否存在、类型是否对得上

System.Text.Json 默认严格区分大小写，JSON 里的 userName 无法绑定到 C# 的 Username 属性；而 Newtonsoft.Json 默认忽略大小写 —— 这会导致迁移时静默失败。

System.Text.Json 统一转驼峰：设 options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
但注意：这个策略只影响**序列化输出**和**反序列化时的匹配逻辑**，不会改你 C# 属性名本身
如果 JSON 是下划线分隔（first_name），两个库都不自带支持，得手动加 [JsonPropertyName] 或写自定义 JsonNamingPolicy
混用两个库时（比如一部分用 JsonConvert，一部分用 JsonSerializer），命名策略不一致极易引发空字段或绑定失败，建议整个项目统一选型