跳到主内容

JSON 转 TypeScript

JSON 转 TypeScript

将 JSON 示例转换为 TypeScript 接口与类型别名,自动处理对象数组字段合并、可选字段与 null 联合推断,并为空数组和空对象生成合适的类型声明。适用于 API 响应建模、前端类型初始化与数据结构整理。

JSON 转 TypeScript

快速开始

1
将有效的 JSON 示例粘贴到左侧编辑器。
2
可选:在生成前设置自定义根类型名,例如 ApiResponse。
3
在右侧查看生成结果。对象根节点会生成 interface;数组和原始值根节点会生成 type。
4
使用复制或下载按钮,把生成的 .ts 输出直接带回项目。

常见使用场景

把真实 API 响应快速整理成前端页面、SDK 客户端或集成测试的 TypeScript 起始模型。

在正式定义接口契约前,先用混合对象数组观察可选字段与联合类型的推断结果。

把 mock JSON 数据快速转换为测试夹具、Storybook 示例或原型阶段可用的类型定义。

当后端响应结构调整时,检查 User、Meta 等嵌套声明是否随样本一起变化。

使用建议

尽量提供有代表性的 JSON 示例。生成器只会根据你粘贴的值推断,没出现的情况不会出现在输出里。
空数组会生成为 unknown[];空对象会生成为扩展 Record<string, unknown> 的 interface,直到你提供更丰富的样本。
嵌套声明会根据属性名做规范化,因此新输出更可能出现 User、Meta 这类名称,而不是旧版的根名前缀形式。
只有在 JSON 合法时才会生成结果。若解析失败,编辑器会提示出错的行号和列号。
合法的自定义根类型名会原样保留;非法名称会被规范化为合法的 PascalCase TypeScript 标识符。

限制与兼容性

该工具基于样本数据推断类型,而不是基于正式 schema。样本里没出现的字段无法被自动猜出。
输入必须是严格 JSON。注释、尾随逗号以及其它 JavaScript 风格语法都会被拒绝。
当前生成结果不会自动附带 export 声明;如果你的项目需要导出,请在生成后手动补充。
输出仅为静态 TypeScript 声明,不会生成运行时校验器、解析器或序列化逻辑。

隐私与安全

所有处理均在您的浏览器内完成,数据不会离开您的设备

常见问题

6

可继续使用这些相关工具,完成后续步骤。