JSON 转 TypeScript
对接第三方接口时手写 TypeScript 类型定义又慢又容易漏字段?
使用方法
- 把 JSON 样本(最好是接口响应体)粘贴进编辑框。
- 需要时修改根类型名(默认 RootObject)。
- 复制生成的 interface:嵌套对象成独立声明,数组带联合与可选字段标记。
- 坏 JSON 会精确报出第几行第几列;修好后结果立即重新生成。
常见问题
类型是怎么推断出来的?
基于你提供的单个 JSON 样本:string、number、boolean、null 直接映射,嵌套对象拆成独立 interface,数组按元素汇总。这是单样本启发式,不是精确类型系统——某个字段偶尔是数字时,只有样本里真的出现数字才会体现,所以请喂给工具一份有代表性的载荷。
字段什么时候会变成可选(?)?
只发生在对象数组上:工具逐字段合并所有元素,只要某字段在至少一个元素里缺席,就输出为可选字段。单个对象里的字段全部必填——孤本样本无法区分"可能缺席"和"不可能出现"。
数组类型是怎么定的?空数组呢?
同构数组取元素类型(string[]);混合原始类型按首次出现顺序生成联合((string | number)[]);对象数组输出合并后的元素 interface。空数组不带类型信息,如实输出 unknown[],不做无依据的猜测。
interface 命名和重名怎么处理?
嵌套接口按父字段名单数化大写命名(items→Item、categories→Category,address 以 ss 结尾保持不变)。字段保持原 JSON 顺序。两处推出同名接口时:形状完全相同就复用同一声明,形状不同则自动加序号(如 Address2)。另外整数型键会被 JavaScript 引擎按升序重排,属语言自身行为。
JSON 不合法会怎样?
工具立即报错,给出解析器定位的精确行号与列号,不输出任何部分结果——坏载荷不会被悄悄变成一组误导性的类型定义。
我的 JSON 会被上传吗?
不会。推理完全在浏览器标签页内本地完成,样本不离开你的设备,私有接口响应也可以放心粘贴。
相关工具
了解更多
对接第三方接口时手写 TypeScript 类型定义又慢又容易漏字段?这款免费的 JSON 转 TypeScript 生成器把样板活儿自动化:粘贴一段 JSON(接口响应最合适),立刻得到可直接粘进项目的 interface 定义,全程在你的浏览器本地完成,生成代码零依赖。推理规则明明白白:字符串、数字、布尔与 null 直接映射;嵌套对象拆成独立 interface,命名取父字段名单数化大写(items 变 Item、address 就是 Address);数组按元素推断——同构数组取元素类型,混合原始类型按首次出现顺序生成联合(如 string | number),对象数组合并全部元素、某个字段哪怕只在个别元素里缺席也会标成可选(?);空数组不带任何类型信息,如实输出 unknown[] 而不是瞎猜。根类型名可配(默认 RootObject),字段保持原 JSON 顺序,两处推出同名接口时形状相同就复用同一声明、形状不同自动加序号避免重复声明。非法 JSON 立即报错并精确到行号列号,绝不输出半猜的产物。它是基于单样本的启发式推理,不是精确类型系统——每条规则都写在 FAQ 里,不超售;你的 JSON 也不离开设备,私有接口响应可以放心粘贴。