JSON 转代码类型教程:一键生成 TypeScript interface 和 Java 实体类
一句话答案
打开 JSON 转 TypeScript(或 JSON 转 Java 实体类),填写根类型名(如 Order),粘贴接口返回的 JSON,自动生成包含嵌套对象的 interface 或 class,检查 null 和数字类型后点“复制结果”。
前后端联调时,拿到一段接口返回的 JSON,第一件事往往是写对应的类型定义。JSON 转 TypeScript 和 JSON 转 Java 实体类 根据 JSON 的结构自动推断字段类型,嵌套对象生成独立的类型,在本地运行,适合处理内部接口数据。
操作步骤
- 选择语言:TypeScript 打开 JSON 转 TypeScript,Java 打开 JSON 转 Java 实体类。
- 填写根类型名:例如 Order,默认 Root;Java 可勾选“生成 getter/setter”。
- 粘贴 JSON:粘贴一段完整的示例数据,字段越全,生成的类型越准确。
- 检查并复制:检查 null、空数组等字段的类型,点“复制结果”。

🟦 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 / number | Java 金额建议用 BigDecimal |
| 大整数 ID | int / number | 超过 21 亿用 long;超过 2^53 时 JS 会丢精度,用字符串 |
| 空数组 | 无法推断元素类型 | 手动补上元素类型 |
JSON 本身格式不对时,先用 JSON 格式化 校验。
常见问题
JSON 转 TypeScript 支持嵌套对象吗?
支持。嵌套对象会生成独立的 interface,数组生成“类型[]”。
为什么有的字段类型是 null?
示例 JSON 里这个字段的值是 null,工具无法推断真实类型,需要按接口文档手动改。
Java 实体类能生成 getter 和 setter 吗?
可以,勾选“生成 getter/setter”即可。
JSON 数据会上传吗?
不会。生成在浏览器本地完成。