将 JSON 转换为 C# class!

输入 JSON,即可生成包含嵌套对象的 C# class 代码!支持 System.Text.Json [JsonPropertyName], .NET, ASP.NET Core。
JSON
结果
 

将 JSON 转换为 C# class!

把 JSON 转换成用于 System.Text.Json 的 C# 类。属性名会转成 PascalCase,每个属性都带有 [JsonPropertyName] 特性,从而精确绑定到原始 key。

编写 ASP.NET Core 的请求和响应模型、为调用外部 API 的 HttpClient.GetFromJsonAsync<T>() 准备类型,或者在 Unity、MAUI 应用中定义数据类时,都能省去逐个复制敲字的功夫。

使用方法

  1. 粘贴 JSON 响应或配置文件。
  2. 在 类型名 中输入根类的名称(例如 PaymentResult)。
  3. 把生成的类放进 .cs 文件,并加上你的 namespace。
  4. 配合 JsonSerializer.Deserialize<PaymentResult>(json) 或 GetFromJsonAsync<PaymentResult>(url) 使用。

示例

输入 (JSON)
{
  "paymentId": "pay_8f2k",
  "amount": 15000,
  "currency": "KRW",
  "approved": true,
  "approvedAt": "2024-05-01T12:30:00Z",
  "card": { "issuer": "VISA", "last4": "4242" },
  "metadata": null
}
输出 (C# · System.Text.Json)
using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;

public class PaymentResult
{
    [JsonPropertyName("paymentId")]
    public string PaymentId { get; set; } = string.Empty;

    [JsonPropertyName("amount")]
    public int Amount { get; set; }

    [JsonPropertyName("currency")]
    public string Currency { get; set; } = string.Empty;

    [JsonPropertyName("approved")]
    public bool Approved { get; set; }

    [JsonPropertyName("approvedAt")]
    public string ApprovedAt { get; set; } = string.Empty;

    [JsonPropertyName("card")]
    public Card Card { get; set; } = new();

    [JsonPropertyName("metadata")]
    public JsonElement? Metadata { get; set; }
}

public class Card
{
    [JsonPropertyName("issuer")]
    public string Issuer { get; set; } = string.Empty;

    [JsonPropertyName("last4")]
    public string Last4 { get; set; } = string.Empty;
}

每个属性都有 [JsonPropertyName],所以无论大小写规则如何,paymentId ↔ PaymentId 都能匹配。metadata 始终为 null,类型未知,因此变成 JsonElement?。字符串和对象属性带有 string.Empty / new() 初始化器,代码编译时不会出现可空性警告。

支持的功能

  • 每个属性都带 [JsonPropertyName("originalKey")],并包含 using System.Text.Json.Serialization;。
  • 类型:string、int,超过 32 位的整数为 long,小数为 double,bool,数组为 List<T>。
  • 类型混杂或未知的值变成 JsonElement,并添加 using System.Text.Json;。
  • 在部分元素中缺失或包含 null 的属性变成可空类型(int?、string?)。
  • 必需属性带有 = string.Empty; 或 = new(); 初始化器,以避免可空引用警告 CS8618。
  • C# 不允许属性与所在类同名,这种属性会加上 Value 后缀(例如 RootValue)。
  • 顶层为数组时,会生成 // Root: List<RootItem> 注释和元素类。

使用场景

用 HttpClient 调用外部 API

转换支付或物流追踪 API 的示例响应,把它用作 await http.GetFromJsonAsync<PaymentResult>(url) 中的类型,而不是从 JsonDocument 里一个个取字段。

ASP.NET Core 中的 webhook payload 模型

根据第三方服务推送过来的 payload 生成类,并作为 [FromBody] 参数接收,模型绑定和校验就能照常工作。

appsettings 和游戏数据文件

用类固定 Unity 或控制台应用读取的 JSON 数据文件的结构,数据文件一旦改动,就会立即以反序列化错误的形式暴露出来。

注意事项与限制

  • 不会生成 Newtonsoft.Json([JsonProperty])的输出。如果使用 Json.NET,请把特性改成 [JsonProperty("key")]。
  • 日期字符串保持为 string。对于 ISO 8601 值,把类型改成 DateTime 或 DateTimeOffset,System.Text.Json 就能解析。
  • 目标类型推断的 new() 和 string? 要求 C# 9+ 并开启可空上下文(自 .NET 6 起为默认)。
  • 不会输出 record 或 required。需要不可变模型时,请把 { get; set; } 改成 { get; init; }。
  • 所有类都在一个代码块中;拆分文件和命名空间请自行处理。

常见问题

key 已经一致了,为什么还要加 [JsonPropertyName]?

System.Text.Json 默认区分大小写。在没有自定义 JsonSerializerOptions 的控制台或 worker 项目中,paymentId 无法绑定到 PaymentId,所以总是写上这个特性,以便不依赖配置也能工作。

怎样读取 JsonElement? 属性?

先检查 ValueKind,再使用 GetString()、GetInt32() 或 Deserialize<T>()。一旦知道了真实类型,用它替换 JsonElement 会更清晰。

能保留 camelCase 的属性名吗?

输出遵循 C# 的 PascalCase 约定。原始 key 保存在 [JsonPropertyName] 中,所以只要保留该特性,属性名可以随意修改。

能配合 Unity 的 JsonUtility 使用吗?

JsonUtility 只处理 [Serializable] 类的 public 字段而不处理属性,并且会忽略 [JsonPropertyName]。在 Unity 中,请改为搭配 Newtonsoft.Json 包或 System.Text.Json 使用输出。