代码生成
JSON 转 C# 类生成器
从 JSON 生成整洁的 C# 类,支持嵌套对象、数组和可空值。
此工具完全在您的浏览器中运行。您粘贴或上传的任何内容都不会发送到我们的服务器。
输入
字符数:0
输出
字符数:0
根类型: —
此根值不需要模型类。
操作
设置
无效字符会被转换为有效的 C# 类名。
添加 #nullable enable,并为引用类型生成可空标注。
使用方法
- 1
添加 JSON
将 JSON 对象或数组粘贴到输入编辑器,或加载示例。所有内容都保留在您的浏览器中。
- 2
配置输出
设置根类名、属性命名、可空引用类型、集合类型和序列化特性。
- 3
生成 C# 类
点击“生成 C#”。生成器会合并对象结构、处理 null 和缺失字段,并避免重复的类名。
- 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 数组吗?
可以。对于顶层对象数组,根类表示数组元素,显示的根类型是集合类型。对于基元根值,不需要模型类。