JSON 转 TypeScript 生成器

从任意 JSON 生成 TypeScript interface 声明。支持嵌套对象、数组、联合类型和可选属性,在浏览器中处理,免费在线工具。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
请输入合法的 TypeScript 名称。留空时使用 RootObject。修改后点击生成 TypeScript 应用。
为所有生成的对象属性添加 ?。未勾选时,对象数组中部分元素缺少的字段仍为可选。点击生成 TypeScript 应用选项。
用 type 替代 interface 生成对象声明。基本类型的根值始终使用 type。点击生成 TypeScript 应用选项。
立即按当前 JSON、根名和选项生成。修改根名或选项后,点击此按钮应用。也可按 Ctrl/⌘+Enter 生成。
用含嵌套对象、数组和 null 的示例替换 JSON 输入,并按当前根名和选项立即生成。
清空 JSON、输出和状态,保留根名及两个选项。在工具内按 Ctrl/⌘+L 还会清空根名。
输入合法 JSON,不能带注释或末尾逗号。停止输入 300 毫秒后自动生成;JSON 无效时会清空输出并显示错误。
TypeScript 输出
复制当前显示的完整 TypeScript 输出。输出为空时不复制。

输入 JSON 或载入示例以生成 TypeScript。

示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

推断规则速查

JSON 值生成的类型
字符串string
数字(整数和小数不区分)number
布尔值boolean
对象属性上的 nullfield?: 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 或生成的代码。