JSON 转 TypeScript

粘贴接口返回的 JSON,自动生成 TypeScript 的 interface 或 type:嵌套对象拆分成独立的类型,合并数组中所有对象的字段,只在部分元素中出现的字段标记为可选,可能为 null 的字段生成联合类型。还可以生成 Zod 校验代码,在运行时检查接口数据。

生成之后的建议

  • interface 还是 type:两者描述对象时几乎可以互换。interface 可以被同名声明合并、在报错信息中显示更友好;type 能表示联合类型、元组等更多形式。团队没有约定时,对象用 interface 即可。
  • 类型只在编译时存在:TypeScript 类型不会检查接口真正返回了什么,后端改了字段,代码照样编译通过。需要在运行时校验接口数据时,可以选择生成 Zod schema,再用 z.infer<typeof Schema> 得到类型,类型和校验只维护一份。
  • 检查可选和 null:只有一条样本时无法知道哪些字段可能缺失。数组中的多个对象会被合并,只在部分对象中出现的字段会标成可选(?)。值为 null 的字段无法推断原本的类型,会生成 null 或 unknown,请按接口文档补全。
  • 日期是字符串:JSON 中没有日期类型,"2026-10-23T08:00:00Z" 解析后仍是 string,需要时用 new Date() 转换,Zod 中可以写 z.coerce.date()。

生成 Go 结构体请用 JSON 转 Go 结构体,生成 JSON Schema 请用 JSON Schema 生成器。

JSON 转 TypeScript常见问题

JSON 转 TypeScript怎么使用?

粘贴 JSON,填写根类型名,选择输出 interface、type 或 Zod schema,按需勾选 export、readonly、嵌套类型写在一起、字符串字面量联合和 null 字段改为可选;右侧实时生成代码,下方提示需要手动确认的字段。

JSON 怎么生成 TypeScript 类型?

粘贴 JSON 后右侧会自动生成 interface,复制到项目中即可。

interface 和 type 用哪个?

描述对象时两者都可以,需要联合类型、元组时用 type。

可选字段是怎么判断的?

数组中有的对象有、有的对象没有的字段会标记为可选。

Zod 有什么用?

在运行时校验接口返回的数据是否符合预期,并能从 schema 推导出 TypeScript 类型。

JSON 转 TypeScript的结果应怎样理解?

类型根据样本推断,只有 null 或空数组的字段无法判断具体类型;Zod 代码基于 Zod 3 的写法。

输入内容会保存或发给外部服务吗?

JSON 数据只在浏览器本地转换,不会上传。

没有结果或操作失败时先检查什么?

生成了 null 或 unknown 类型时,说明样本中没有该字段的实际值,请按接口文档补全。

相关工具

package.json 生成器 · 字号比例计算器 · JSON 格式化校验 · Base64 编码解码 · 全部开发工具