1Tools
输出形态
命名风格
缩进
引号
JSON
TypeScript

编码与文本

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 也能放心粘贴。

怎么用

  1. 01

    把 JSON 拿来。粘到左侧编辑器,或上传一个 .json 文件,也可以先用内置示例看看输出长什么样。

  2. 02

    选输出形态。interface 还是 type alias、根类型叫什么名,命名风格、缩进和引号按你现有代码库的习惯调一下。

  3. 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、不用命令行、不用构建步骤,任何有浏览器的机器都能用。

  • 免费且不限量

    没有试用、没有付费墙,样例体积也不设上限。

常见问题

JSON 格式化与校验JSON 对比Base64 编码与解码全部工具返回首页