跳到主要内容
DevDataKit
打开菜单

代码生成

JSON 转 C# 类生成器

从 JSON 生成整洁的 C# 类,支持嵌套对象、数组和可空值。

在浏览器中运行

此工具完全在您的浏览器中运行。您粘贴或上传的任何内容都不会发送到我们的服务器。

输入

字符数:0

输出

字符数:0

根类型: —

操作

校验状态:就绪

设置

无效字符会被转换为有效的 C# 类名。

添加 #nullable enable,并为引用类型生成可空标注。

使用方法

  1. 1

    添加 JSON

    将 JSON 对象或数组粘贴到输入编辑器,或加载示例。所有内容都保留在您的浏览器中。

  2. 2

    配置输出

    设置根类名、属性命名、可空引用类型、集合类型和序列化特性。

  3. 3

    生成 C# 类

    点击“生成 C#”。生成器会合并对象结构、处理 null 和缺失字段,并避免重复的类名。

  4. 4

    复制或下载

    复制生成的 C#,或下载为 .cs 文件,然后为项目添加命名空间并配置序列化器。

示例

JSON

{
  "user": {
    "id": 1,
    "name": "Ada"
  }
}

生成的 C#

// Generated by DevDataKit JSON to C# Class Generator.
// Root type: Root
#nullable enable
using System.Text.Json.Serialization;

public sealed class Root
{
    [JsonPropertyName("user")]
    public User User { get; set; } = null!;
}
public sealed class User
{
    [JsonPropertyName("id")]
    public int Id { get; set; }
    [JsonPropertyName("name")]
    public string Name { get; set; } = null!;
}

这个简单示例展示了 JSON 中的 user 对象如何生成根类和嵌套的 User 类。

JSON 转 C# 类生成指南

JSON 转 C# 转换的作用

此工具解析 JSON 文档,推断其对象和数组的结构,并输出 C# 模型类。它适合为 API、配置负载和集成测试创建 DTO,无需手写大量样板代码。

生成过程是对 JSON 结构的静态分析。它不会运行或执行输入,生成的类只是项目开发的起点,而不是完整的应用层。

JSON 属性如何映射到 C# 属性

每个 JSON 属性都会变成一个 public C# 属性。PascalCase 会创建符合 C# 习惯的名称;“保留原始 JSON 名称”会在名称是有效标识符时保留输入拼写。

保留关键字会被转义,无效字符会被清理,命名冲突会获得确定性的数字后缀。当 C# 标识符与 JSON 名称不同时,序列化特性会保留原始 JSON 名称。

可空属性

如果属性显式为 null,或在数组的至少一个对象中缺失,它就会被标记为可空。值类型使用 int? 等可空形式;启用可空引用类型时,引用类型使用 string? 或 Class?。

启用可空引用类型时,输出会包含 #nullable enable,并在适当位置为非空引用生成初始值。如果项目使用较旧的可空禁用上下文,请关闭该选项。

嵌套对象与集合

嵌套对象会生成独立的类。对象数组会为元素结构生成类,基元数组使用 List<T> 或 T[],嵌套数组会生成嵌套集合类型。

当数组中的对象具有不同属性时,结构会合并,缺失的字段变为可空。相同的对象结构会复用一个类,类名冲突会获得安全的数字后缀。

System.Text.Json 与 Newtonsoft.Json

System.Text.Json 使用 System.Text.Json.Serialization 中的 JsonPropertyName 特性。Newtonsoft.Json 使用 Newtonsoft.Json 命名空间中的 JsonProperty 特性。

请选择应用程序已经在使用的序列化器。生成的 using 指令和特性会与选择一致;只有当 C# 名称与 JSON 名称不同时才会添加特性。

常见使用场景

该生成器适用于接入新 API、创建类型化的请求和响应模型、查看 JSON 负载结构、构建配置类,或为 .NET 应用快速生成 DTO。

在生产使用前请审查生成的代码:添加命名空间、配置序列化器、决定使用 record 还是 class,并检查应用程序如何表示日期、小数和未知值。

常见问题

生成的 C# 代码可以直接编译吗?

生成器输出标准 C# 类和特性。开发过程中会使用 .NET SDK 编译代表性输出。您仍需为应用程序添加合适的命名空间、项目目标和序列化包/配置。

JSON 属性名如何映射到 C# 属性?

PascalCase 会把 user_name 这样的名称转换为 UserName;“保留原始 JSON 名称”会保留有效名称。当生成的标识符与 JSON 名称不同时,会使用 JsonPropertyName 或 JsonProperty 特性保留原始名称。

可空属性和缺失属性会怎样处理?

当属性值为 null,或在数组中的某些对象里缺失时,该属性会被标记为可空。可空值类型使用 ?;启用可空引用类型时,引用类型也会使用 ?。该选项同时控制 #nullable 指令和非空初始值。

嵌套对象和数组如何处理?

嵌套对象会生成独立的类。对象数组会生成元素类;基元数组使用 List<T> 或 T[],嵌套数组会生成嵌套集合。数组中的对象结构会合并,从而保留每个对象的字段。

异构数组如何处理?

包含不同对象结构的数组会合并为一个类,缺失字段变为可空。对象与基元值混合的数组使用 object,因为单一强类型无法在不丢失数据的情况下表示所有元素。

应该选择哪种序列化特性?

如果项目使用 System.Text.Json,请选择 System.Text.Json;如果使用 Newtonsoft,请选择 Newtonsoft.Json。生成的 using 指令和特性会与选择一致,且只在需要时添加特性。

我的 JSON 会上传到服务器吗?

不会。JSON 解析、类型推断、C# 生成、复制和下载全部在您的浏览器本地完成。

可以转换顶层 JSON 数组吗?

可以。对于顶层对象数组,根类表示数组元素,显示的根类型是集合类型。对于基元根值,不需要模型类。

可用

数据与 JSON

JSON 格式化工具

美化、压缩、校验和排序 JSON,并提供清晰的行列错误提示。

在浏览器中运行打开工具
可用

日期与时间

时间戳转换器

在 Unix 时间戳、日期时间、UTC 和所选时区之间相互转换。

在浏览器中运行打开工具