JSON 转实体类
粘贴 JSON 自动推断类型 · 生成 Java / TypeScript / Python / Go / C# / PHP 代码
JSON 输入
对象或对象数组生成选项
生成结果
类型是怎么推断的
JSON 本身不带类型信息,工具按下面的规则读一遍你的数据(**规则就是这些,没有隐藏逻辑**):
| JSON 里的值 | Java | TypeScript | Python | Go |
|---|---|---|---|---|
| 整数且在 int 范围内 | Integer | number | int | int |
| 整数但超出 int(±2147483648) | Long | number | int | int64 |
| 小数 / 科学计数法 | Double | number | float | float64 |
| true / false | Boolean | boolean | bool | bool |
| 字符串 | String | string | str | string |
| null(这一处是 null) | Object | any | Any | interface{} |
| 空数组 [] | List<Object> | any[] | List[Any] | []interface{} |
| 数组 | List<元素类型> | 元素类型[] | List[元素类型] | []元素类型 |
| 嵌套对象 | 静态内部类 | 嵌套 interface | 独立 dataclass | 独立 struct |
类型冲突与缺失怎么处理(不静默选一个):
- 同一字段在不同数组元素里类型不同(例如一处是数字、一处是字符串):按"无法确定"处理,生成
Object/any,并在结果上方的提示里点名是哪个字段、出现了哪几种类型,由你决定改成什么。 - null:无法从 null 推断类型,单独出现时给
Object/any;与其它类型同时出现时按另一边的类型生成,并在注释里标注"可能为 null"。 - 空数组:不知道元素类型,给
List<Object>/any[]并提示。 - 某字段只在部分元素里出现:TypeScript 标为可选(
name?:),Java / C# / Go 在注释或 tag 里标注(Java 用Integer这类包装类型天然可空)。 - JSON 里的字段名不是合法标识符或撞上语言关键字(
user-name、class、1st、中文名):会改写成合法标识符,并尽最大可能保留原始 key——Java 用@JsonProperty、C# 用[JsonPropertyName]、Go 的json:"…"tag 一定带、Python 用field(metadata={"json": …})、TypeScript 干脆直接用原始 key 当属性名(带引号),因为 TS 没有注解机制、属性名就是运行时字段名。 - 改名后的映射代价(如实说明):Java / C# / Go 靠注解或 tag 自动映射,无需手工处理;TypeScript 用原始 key 所以天然正确;Python 的
metadata只有 dataclasses-json / pydantic 这类库会读,直接Root(**json.loads(x))遇到改名属性会报错;PHP 的json_decode按属性名严格映射,改名属性旁边会写/** 对应 JSON 字段: … */注释,序列化/反序列化时请据此手工处理(或改用数组访问)。 - 数字精度:超过 ±2^53 的整数在 JS 里已经没有精度,工具会提示你改用字符串(生成
String),不要用Long去接一个已经失真的值。 - 类名撞上语言内置类型名(例如字段叫
list派生出的类名List,会遮蔽 Java 的java.util.List/ C# 的System.Collections.Generic.List,直接编译不过):会自动加Model后缀(List→ListModel),同名字段仍然照常生成。
生成的代码是起点不是终点:Java 用 Lombok 还是手写 getter/setter、是否加 @JsonIgnoreProperties(ignoreUnknown = true)、日期字段用 String 还是 LocalDateTime,都请按你项目的规范微调。本工具不联网、不读取你项目的任何配置。
常见问题
JSON 里没有类型信息,工具只能按你这一份数据的实际取值推断:null 单独出现时推不出类型,会给 Object / any;空数组不知道元素类型,会给 List<Object> / any[];同一字段在不同数组元素里类型不一致时,会按"无法确定"生成 Object / any,并在上方提示里点名是哪个字段、出现了哪几种类型。也就是说,工具不猜、也不静默替你选一个——把这几种情况当成「需要你确认的字段」。
会按目标语言的规则处理,并尽量保住原始字段名:Java 改写成 userName / class_ / _1stLogin 并加 @JsonProperty("user-name");C# 同样加 [JsonPropertyName];Go 一律带 json:"user-name" tag;Python 用 class_ 这类合法名 + field(metadata={"json": "user-name"});TypeScript 最直接——属性名就写 "user-name": string(TS 没有注解机制,属性名就是运行时字段名,改成 camelCase 反而会让 JSON.parse 的结果对不上)。中文 key 原样保留(Java / Python / TypeScript 都允许中文标识符)。要提醒的是:Python 的 metadata 只有 dataclasses-json / pydantic 这类库会读,PHP 的 json_decode 按属性名严格映射,这两种语言遇到改名字段时要照生成的注释手工接一下。
会。校验是自己实现的严格解析器,报错给出行号、列号和一句人话说明(例如「第 3 行第 12 列:对象里的属性名必须用双引号」),常见的坑会单独识别:单引号字符串、注释、结尾多余逗号、数字前面多个 0、true/false/null 拼错、括号没有闭合。解析器还限制嵌套深度 64 层、节点数 2 万个,超限会明确告诉你,不会把页面卡死。
Java(Lombok 或原生 getter/setter,可选 Jackson @JsonProperty)、TypeScript 接口、Python dataclass、Go struct、C# class、PHP class 六种。不会上传:解析、推断、生成全部在你的浏览器里完成,数据不出本机、刷新即清空,页面里没有任何上传请求,也没有第三方依赖(不用 CDN)。如果 JSON 里有真实姓名、手机号、身份证号等敏感字段,本地转换正是为了不把它们发给任何服务器。