JSON 转 TypeScript 接口生成器 | fixjson.org

input.json

{
  "id": 1,
  "name": "Alice Johnson",
  "email": "alice@example.com",
  "age": 30,
  "active": true,
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "zip": "10001"
  },
  "tags": ["admin", "editor"],
  "orders": [
    { "id": 101, "total": 49.99, "status": "shipped" },
    { "id": 102, "total": 99.00, "status": "pending" }
  ]
}

types.ts

点击转换生成 TypeScript 接口。

相关

与 TS Types 相关的指南

全部指南 →

修复 LLM 的 JSON 输出：处理来自 AI 的“准 JSON”

LLM 经常返回被 ```json 围栏包裹的 JSON，带有单引号、Python 字面量或未加引号的键。修复语法，严格校验，然后从清理后的输出推导 TypeScript 类型。

修复 LLM 输出的 JSON

AI 响应看似 JSON，但常常夹带 markdown 围栏、注释、Python 风格字面量或 JavaScript 对象语法。

JSON 与 JavaScript 对象字面量的区别

JSON 看起来像 JavaScript 对象字面量，但它是一种更小、语法更严格、不包含可执行值的数据格式。

JSON 转 TypeScript 的工作方式

每个 JSON 对象都会生成一个 TypeScript interface。根对象默认命名为 Root。嵌套对象会按对应的属性键生成各自的命名接口 —— 名为 address 的键会得到一个 Address 接口。

数组与可选字段

对象数组会合并所有元素中出现过的键。如果某些项缺失了某个键，它会变成可选属性（key?: Type）。基本类型数组会得到带类型的签名，例如 string[] 或 number[]。

什么时候用它

API 接入 —— 贴上响应体，立刻得到可以放进 TypeScript 项目的类型定义
原型阶段 —— 在着手解析逻辑之前，先快速搭起对新 API 或数据集的接口骨架
代码评审 —— 确认 JSON 负载的形状与代码期望的接口一致