企评社

JSON 转实体类

粘贴 JSON 自动推断类型 · 生成 Java / TypeScript / Python / Go / C# / PHP 代码

全部在浏览器本地转换,数据不上传、刷新即清空

JSON 输入

对象或对象数组
示例:

生成选项

生成结果


        

类型是怎么推断的

JSON 本身不带类型信息,工具按下面的规则读一遍你的数据(**规则就是这些,没有隐藏逻辑**):

JSON 里的值 Java TypeScript Python Go
整数且在 int 范围内Integernumberintint
整数但超出 int(±2147483648)Longnumberintint64
小数 / 科学计数法Doublenumberfloatfloat64
true / falseBooleanbooleanboolbool
字符串Stringstringstrstring
null(这一处是 null)ObjectanyAnyinterface{}
空数组 []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-nameclass1st、中文名):会改写成合法标识符,并尽最大可能保留原始 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 后缀(ListListModel),同名字段仍然照常生成。

生成的代码是起点不是终点:Java 用 Lombok 还是手写 getter/setter、是否加 @JsonIgnoreProperties(ignoreUnknown = true)、日期字段用 String 还是 LocalDateTime,都请按你项目的规范微调。本工具不联网、不读取你项目的任何配置。

常见问题

生成的类型准不准?null 和空数组怎么办?

JSON 里没有类型信息,工具只能按你这一份数据的实际取值推断:null 单独出现时推不出类型,会给 Object / any;空数组不知道元素类型,会给 List<Object> / any[];同一字段在不同数组元素里类型不一致时,会按"无法确定"生成 Object / any,并在上方提示里点名是哪个字段、出现了哪几种类型。也就是说,工具不猜、也不静默替你选一个——把这几种情况当成「需要你确认的字段」。

字段名是 user-name、class、1st 或中文,会生成什么?

会按目标语言的规则处理,并尽量保住原始字段名: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 按属性名严格映射,这两种语言遇到改名字段时要照生成的注释手工接一下。

JSON 写错了怎么提示?会定位到行吗?

会。校验是自己实现的严格解析器,报错给出行号、列号和一句人话说明(例如「第 3 行第 12 列:对象里的属性名必须用双引号」),常见的坑会单独识别:单引号字符串、注释、结尾多余逗号、数字前面多个 0、true/false/null 拼错、括号没有闭合。解析器还限制嵌套深度 64 层、节点数 2 万个,超限会明确告诉你,不会把页面卡死。

支持哪些语言?会上传我的 JSON 吗?

Java(Lombok 或原生 getter/setter,可选 Jackson @JsonProperty)、TypeScript 接口、Python dataclass、Go struct、C# class、PHP class 六种。不会上传:解析、推断、生成全部在你的浏览器里完成,数据不出本机、刷新即清空,页面里没有任何上传请求,也没有第三方依赖(不用 CDN)。如果 JSON 里有真实姓名、手机号、身份证号等敏感字段,本地转换正是为了不把它们发给任何服务器。

相关工具