GUIDE深度 · Deep dive

JSON 转 TypeScript:interface 还是 type

对象通常用 interface,联合/别名/数组用 type;两者多数场景可互换。关键不是语法,而是把可选字段、null、数组元素类型和嵌套对象表达清楚,并在运行时校验。

更新 2026-10-31 · 公式可核验

选择

对象/可扩展:interface。

联合/映射/别名:type。

数组元素:`Item[]`。

别漏

字段可能缺失 → `?`。

可能为 null → `| null`。

空数组 → 先定元素类型。

常见问题

生成类型能直接用吗?

可以当起点;正式项目补联合/校验/文档。

为什么要运行时校验?

TS 类型编译后消失,外部 JSON 仍可能不符合。

数据来源

相关计算器

JSON 转 TypeScript粘贴 JSON,生成 interface/type;数组对象合并字段、缺失字段可选,本地处理不上传。

更多指南

API JSON 校验:类型、可选字段和版本阅读指南