🔍

首页 › 使用教程 › 开发与效率

JSON 转代码类型教程:一键生成 TypeScript interface 和 Java 实体类

发布于 · 阅读约 2 分钟 · 用到的工具:JSON 转 TypeScript、JSON 转 Java 实体类

一句话答案

打开 JSON 转 TypeScript(或 JSON 转 Java 实体类),填写根类型名(如 Order),粘贴接口返回的 JSON,自动生成包含嵌套对象的 interface 或 class,检查 null 和数字类型后点“复制结果”。

本文目录
  1. 操作步骤
  2. 生成结果示例
  3. 需要人工调整的地方
  4. 常见问题

前后端联调时,拿到一段接口返回的 JSON,第一件事往往是写对应的类型定义。JSON 转 TypeScript 和 JSON 转 Java 实体类 根据 JSON 的结构自动推断字段类型,嵌套对象生成独立的类型,在本地运行,适合处理内部接口数据。

操作步骤

  1. 选择语言:TypeScript 打开 JSON 转 TypeScript,Java 打开 JSON 转 Java 实体类。
  2. 填写根类型名:例如 Order,默认 Root;Java 可勾选“生成 getter/setter”。
  3. 粘贴 JSON:粘贴一段完整的示例数据,字段越全,生成的类型越准确。
  4. 检查并复制:检查 null、空数组等字段的类型,点“复制结果”。
一个订单 JSON 生成 Order、Item、Customer 三个 TypeScript 接口
一个订单 JSON 生成 Order、Item、Customer 三个 TypeScript 接口
🟦 JSON 转 TypeScript
免费在线使用,文件和数据只在你的浏览器本地处理,无需注册。
打开工具 →

生成结果示例

输入 JSON:

{"id": 1024, "paid": true, "amount": 99.5,
 "customer": {"name": "张伟", "city": "杭州"},
 "items": [{"sku": "A-1", "qty": 2}], "coupon": null}

TypeScript 输出(节选):

export interface Order {
  id: number;
  paid: boolean;
  amount: number;
  customer: Customer;
  items: Item[];
  coupon: null;
}

Java 输出中,id 和 qty 推断为 int,amount 为 double,items 为 List<Item>,customer 生成独立的 Customer 类。

需要人工调整的地方

情况自动结果建议改成
值为 null 的字段null 类型按接口文档写成 string 或 null 联合类型
可能缺失的字段必填TypeScript 加 ?,Java 用包装类型
金额double / numberJava 金额建议用 BigDecimal
大整数 IDint / number超过 21 亿用 long;超过 2^53 时 JS 会丢精度,用字符串
空数组无法推断元素类型手动补上元素类型

JSON 本身格式不对时,先用 JSON 格式化 校验。

常见问题

JSON 转 TypeScript 支持嵌套对象吗?

支持。嵌套对象会生成独立的 interface,数组生成“类型[]”。

为什么有的字段类型是 null?

示例 JSON 里这个字段的值是 null,工具无法推断真实类型,需要按接口文档手动改。

Java 实体类能生成 getter 和 setter 吗?

可以,勾选“生成 getter/setter”即可。

JSON 数据会上传吗?

不会。生成在浏览器本地完成。