编码与文本
JSON 转 TypeScript
JSON 转 TypeScript,就是把一份 JSON 样例转成对应的 TypeScript 类型。把 JSON 粘到左边,选 interface 还是 type alias,工具会自动写出嵌套接口、数组元素类型和可选字段,直接贴进项目就能用。整个过程在浏览器里完成,JSON 不会离开你的设备。
JSON 转 TypeScript 是从 JSON 样例推导 TypeScript 类型定义的做法,让编译器替你检查数据结构,而不是运行时靠猜。
无论你叫它 JSON 转 TS 生成器,还是 TypeScript 类型生成器,结果一样:给已有数据一份可依赖的类型契约。
你能做什么
interface 与 type 别名任选
按团队习惯选输出形态。嵌套对象会生成嵌套接口,数组会生成带名字的元素类型 —— JSON 转 TypeScript 的 interface 生成器会处理深度结构,不只管最外层。
识别可选与可空字段
样例数据比裸 schema 携带更多信息:某个字段只在一处出现会被标成可选,同一个字段既有值又有 null,会变成可空联合类型。
类型命名由你决定
根类型自己起名,成员可选 PascalCase 或 camelCase,缩进可选 tab 或空格、引号可选单引号或双引号,贴进代码库不用二次清理。
面向 API 响应与大体积
粘一份接口响应、fixture 或配置导出即可。深层嵌套与大数组都能处理,输出按概念拆分类型,而不是一坨内联字面量。
完全在浏览器内运行
转换在你自己的机器上完成,不上传、不用注册、不要 API key,也不留存 —— 含客户记录或凭据的 payload 也能放心粘贴。
怎么用
- 01
把 JSON 拿来。粘到左侧编辑器,或上传一个 .json 文件,也可以先用内置示例看看输出长什么样。
- 02
选输出形态。interface 还是 type alias、根类型叫什么名,命名风格、缩进和引号按你现有代码库的习惯调一下。
- 03
拿走类型。复制到剪贴板,或下载成 .ts 文件,在需要这个数据形状的地方直接 import。
关于 JSON 转 TypeScript
JSON 转 TypeScript 解决什么
JSON 样例只告诉你「现在这份数据长什么样」,却不告诉代码「可以假设什么」。JSON 转 TS 生成器把样例变成可粘进项目的类型契约。
别再靠 any 猜
一旦 fetch 回来、赋给变量、再传进几层函数,`any` 就悄悄接管 —— 字段名写错不再是编译错误,而是线上半夜才炸的意外。从样例生成 TypeScript,让 `response.user.email` 由编译器把关。
嵌套对象变成命名类型
嵌套对象会各自生成命名的 interface。`billing.address` 会得到独立的 `Address` 类型,而不是把类型硬塞进主类型里变成一长串内联字面量。读起来像人写的代码。
数组、可选字段与根级列表
数组会生成带名字的元素类型,`BillingAddress[]` 比重复写 `{ street: string }[]` 好读。有的记录有 `nickname`、有的没有,该属性就会标成可选。根级数组也会起好根类型,输出 `RootType[]`。 生成类型前若要先对比两份接口响应,可先打开 JSON Diff 工具。
选 interface、type 别名还是 class?
按代码库习惯选输出形态。本工具生成 interface 或 type alias;class 输出尚未提供。
输出 适合 联合类型 运行时行为 说明 interface 可能被继承或合并的对象形状 否 无 JSON 数据的默认输出 type alias 联合类型、原始类型与单一命名形状 是 无 字段可能是多种类型时用 class 需要方法与运行时行为的数据 是 方法与字段 本工具暂不生成 类型不是校验器
生成的类型描述的是你粘贴的那份样例,不是接口的真面目。类型是编译期契约,不是运行时保证 —— 它没法验证网络上真正到达的数据是否仍匹配。
cast 不等于检查
`data as User` 只是让编译器闭嘴。来自不受你控制的接口时,应先生成类型,再在运行时校验。若需先清理或校验样例,可用 JSON 格式化工具。
用 JSON 样例还是 JSON Schema?
两条路最终都通向 TypeScript,但出发点不同。已有响应或 fixture 时,样例优先更快;已有正式描述时,schema 优先更精确 —— 有 schema 就用 schema,否则粘样例继续干活。
来源 从何开始 精度 联合类型 何时使用 JSON 样例 你已有的真实数据 反映样例里出现过的内容 仅样例展示出的 探索接口、原型期、给 fixture 补类型 JSON Schema 允许形状的正式描述 受 schema 规则约束 按声明支持 schema 已存在且必须强制
私密、快速、免费
完全在浏览器内运行
转换在本地完成,不上传,也不留存你的 JSON 副本。
免注册
打开页面就能转,没有账号、登录和 API key。
免安装
不用 Node.js、不用命令行、不用构建步骤,任何有浏览器的机器都能用。
免费且不限量
没有试用、没有付费墙,样例体积也不设上限。