功能概览
能做什么
- • 自动从 JSON 生成 TS 接口
- • 实时转换与预览
- • 嵌套对象生成子接口
输入要求
- • 必须是合法 JSON
- • 顶层数组支持，但按首个元素推断
- • 混合类型数组需手动调整
快速上手
- 打开 /json-to-typescript
- 将 JSON 粘贴到左侧输入框
- 在右侧查看生成的接口
- 复制 或下载
类型映射
基础类型
- • string → string
- • number → number（无整/浮区分）
- • boolean → boolean
- • null → null（可手动细化）
复杂类型
- • array → T[]（基于首个元素）
- • object → 子接口（如 AddressInterface）
- • 嵌套对象 → 独立接口 + 字段引用
数组与嵌套对象
良好示例
{
"users": [{ "id": 1, "name": "A" }]
}需注意
{
"values": [1, "two", true]
}类型混合；可调整为联合类型或规范化数据。
示例
输入 JSON
{
"name": "Alice",
"age": 28,
"active": true,
"address": { "city": "Paris" },
"tags": ["dev", "ts"]
}
生成的接口
interface RootObject {
name: string;
age: number;
active: boolean;
address: AddressInterface;
tags: string[];
}
interface AddressInterface {
city: string;
}建议与限制
推荐做法
- • 转换前先校验 JSON
- • 按领域语义重命名接口
- • 需要时补充可选修饰符 (?)
限制
- • 混合数组按首个元素推断
- • 不自动检测可选/联合类型
- • 复杂结构可能需要手动优化