JSON 转 TypeScript 生成器
从任意 JSON 生成 TypeScript interface 声明。支持嵌套对象、数组、联合类型和可选属性,在浏览器中处理,免费在线工具。
- 在浏览器中处理
- 工具不会把输入上传到 ZeroTool 服务器
- 免费 · 无需注册
用微信扫描以下二维码即可分享
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。
推断规则速查
| JSON 值 | 生成的类型 |
|---|---|
| 字符串 | string |
| 数字(整数和小数不区分) | number |
| 布尔值 | boolean |
对象属性上的 null | field?: null |
对象数组里每个元素都是 null 的键 | field: null(不加 ?) |
| 空数组 | unknown[] |
| 基本类型混合的数组 | 联合类型,如 (string | number)[] |
| 对象数组 | 合并成一个元素接口,如 RecordsItem[] |
| 嵌套对象 | 单独的具名接口 |
根接口排在最前,其余接口按第一次遇到的顺序排列。
示例:后端分页接口里的 19 位 ID
很多 Java 后端用 MyBatis-Plus 的 IdType.ASSIGN_ID 给主键分配 ID。按 MyBatis-Plus 注解文档,这个策略适用于 Long、Integer、String 类型的主键,默认用雪花算法生成。下面是一个分页接口的返回值,根接口名称填 ApiResult:
{"code":200,"msg":"操作成功","data":{"records":[{"id":1830000000000000001,"userName":"张三","deptId":103,"createTime":"2026-10-08 09:30:00","remark":null}],"total":1}}
生成:
interface ApiResult {
code: number;
msg: string;
data: Data;
}
interface Data {
records: RecordsItem[];
total: number;
}
interface RecordsItem {
id: number;
userName: string;
deptId: number;
createTime: string;
remark: null;
}
类型本身没错,问题在值:1830000000000000001 大于 Number.MAX_SAFE_INTEGER(9007199254740991,见 MDN),前端用 JSON.parse 读到的是 1830000000000000000,末位已经变了,拿它去查详情或删除会对不上记录。这个工具同样用 JSON.parse 读输入,所以既不会提示,也只能给出 number。处理办法是让后端把这类 ID 输出成字符串,再把 id 的类型改成 string。
另外三处要留意:createTime 是「年-月-日 时:分:秒」格式的字符串,类型就是 string;remark 在 records 数组里,所以是不带 ? 的 null,查文档后改成 remark: string | null;分页对象如果还有 size、current 等字段,要贴进样本里才会出现。
示例:中文键名
导出报表或低代码平台给出的 JSON 常用中文键名。根接口名称填 订单:
{"订单号":"A-1001","收货地址":{"省份":"浙江省","城市":"杭州市"},"商品列表":[{"名称":"龙井茶","数量":2},{"名称":"茶具","数量":1,"备注":"礼盒装"}]}
生成:
interface 订单 {
"订单号": string;
"收货地址": 收货地址;
"商品列表": 商品列表Item[];
}
interface 收货地址 {
"省份": string;
"城市": string;
}
interface 商品列表Item {
"名称": string;
"数量": number;
"备注"?: string;
}
属性名一律加引号(工具只把 ASCII 字母、数字、_、$ 组成的键当作标识符),接口名直接用中文,两者在 TypeScript 中都合法。备注 只在第二件商品里出现,所以带 ?。用的时候写 order["收货地址"].城市 或 order.收货地址.城市 都可以。
生成后要改的地方
?: null和: null:换成真实类型加| null。unknown[]:空数组看不出元素类型,需要补上。- 日期:ISO 8601 字符串和「2026-10-08 09:30:00」这类字符串保持
string,Unix 时间戳保持number。 ItemsItem、Same_name、PaymentMeta这类名称由键名生成,可以按业务改名。两个同名键的对象字段不同时,第二个会加上父级名称(payment.meta得到PaymentMeta),仍被占用时再加数字(Meta2);根接口始终保留你填的名称。- 键名生成不了合法类型名时(
2fa、空键名),接口名加前缀T(T2fa),属性仍用带引号的原键名。
限制
- 输入必须是合法 JSON,不能有注释或末尾逗号。不合法时输出被清空,状态栏给出出错的行、列和可能的原因,行列按你输入的原文计算。例如输入
{"a":1,}时显示JSON 格式错误:第 1 行第 7 列,右括号前多了一个逗号。从中文输入法里带进来的中文引号(“”)也会被指出来:{“订单号”: "A-1001"}显示JSON 格式错误:第 1 行第 2 列,“ 是中文引号,JSON 要用英文双引号(")。 - 根是数组、且对象与其他值混在一起时(如
[{"id": 1}, "x", null]),对象合并成以根名称命名的接口,另外生成一个表示整个数组的别名,写法和嵌套数组相同:type RootObjectArray = (string | null | RootObject)[];。接口返回值用RootObjectArray。 - 根接口名称按 ECMAScript 标识符规则处理:保留各国文字的字母、数字以及
$、_;其他字符被去掉、后一个字母变成大写(user profile得到userProfile);不能作为开头的加前缀T(2fa得到T2fa);保留字或基本类型名加后缀_(class得到class_)。什么都不剩时用 RootObject。 - 与 TypeScript 标准库(
lib.dom.d.ts与各个lib.es*.d.ts)中名称只有一个单词的全局类型(如Promise、Date、Map、Record、Body、Response、Event、JSON、URL)同名时,不会原样使用这个名称:这样的声明在没有import/export的文件里会和全局类型合并,在模块里则会遮住全局类型。嵌套对象改为在前面加父级名称({"date": {"year": 2026}}得到RootObjectDate,键"URL"得到RootObjectURL;键"url"得到Url,不是全局类型),根名称加后缀_(Map得到Map_)。根名称globalThis同样加_(globalThis_):在没有import/export的文件里,TypeScript 不接受以它命名的声明。只作为全局值存在的名称(如Image、Intl、Proxy)保持原样,因为同名的 interface 或 type 与它们不冲突。 - 由多个单词组成的全局类型名(如
formData键生成的FormData)保持生成的名称;要粘进没有import/export的文件,或粘进的模块里还要用这个全局类型时,请自己改名。 - 嵌套极深时可能超出浏览器的调用栈,这时状态栏显示错误,并清空之前的输出。
- 类型只来自你粘贴的样本。样本里是字符串、线上有时是数字的字段,仍会是
string。 - 勾选「使用 type 替代 interface」后,每个声明写成
type Name = { ... };状态栏仍显示「接口」。
FAQ
这个工具生成什么?
它从 JSON 对象生成 TypeScript interface(或 type 别名)声明。每个嵌套对象都会被提取为独立的具名接口;数组中的混合类型会生成联合类型。
嵌套对象如何处理?
每个嵌套对象字段会被提取为单独的接口,名称是字段名的 PascalCase。例如字段 address 对应 Address 接口,父接口用这个名称引用它。只有连字符、空格等分隔符后面的字母会变成大写,所以 user-info 得到 UserInfo,same_name 得到 Same_name。中文键名的接口名保留中文,例如「收货地址」。如果名称与 TypeScript 中只有一个单词的全局类型(如 Date、Response)相同,就在前面加上父级名称(RootObjectDate)。
对象数组如何处理?
数组里的所有对象会合并成一个元素接口。只在部分对象里出现的字段加 ?;同一个字段在不同元素里类型不同时,写成联合类型,例如 (null | string)。
「属性设为可选」有什么用?
勾选后,所有生成接口的每个属性都会加上 ? 后缀,变为可选。适合期望接收不完整数据或需要宽松类型定义的场景。勾选后要点击「生成 TypeScript」才会应用。
interface 和 type 有什么区别?
两者都可以描述对象结构。interface 支持声明合并,是对象类型的惯用写法;type 更灵活,还可以表示基本类型、联合类型和元组。勾选「使用 type 替代 interface」可切换输出关键字。
数据会发送到服务器吗?
不会。页面在浏览器里根据你的 JSON 推断类型,不把 JSON 发送到任何地方,也不保存到浏览器存储。页面的统计只在你改完输入、焦点离开输入框后,或点击「生成 TypeScript」「示例」时记录一次使用事件(工具名和动作 generate),不包含 JSON 或生成的代码。