JSON 转 C# 实体类完整指南

2026-06-08

场景

对接 REST API 时，响应 JSON 需要映射为强类型 C# 对象。手工编写类费时且易漏字段。

在线转换

使用 JSON 转 C# 工具：

  1. 粘贴 API 响应 JSON。
  2. 点击执行，获得带属性的 C# 类定义。
  3. 将类复制到项目中，按需调整命名空间与可空类型。

代码中使用

var user = JsonSerializer.Deserialize<User>(json);

若使用 Newtonsoft.Json：

var user = JsonConvert.DeserializeObject<User>(json);

嵌套对象与数组

  • 嵌套 JSON 对象会生成嵌套类。
  • 数组映射为 List<T>。
  • 属性名默认 PascalCase，与 System.Text.Json 默认策略一致。

最佳实践

  • 对可空字段使用 string?、int?。
  • 为 API 模型单独建 DTO，不要与领域实体混用。
  • 结合单元测试验证反序列化。

相关工具