JSON转TypeScript接口 - 自动生成TS类型定义

一款免费的在线 JSON to TypeScript 转换工具。根据JSON数据自动生成TypeScript接口、类型定义,支持嵌套对象、数组等复杂结构。纯本地计算,数据隐私绝对安全。

生成选项

# 什么是 JSON 转 TypeScript 接口?

JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,而 TypeScript 是 JavaScript 的超集, 提供了静态类型检查。JSON 转 TypeScript 接口是将 JSON 数据结构转换为 TypeScript 类型定义的过程, 帮助开发者在代码中实现类型安全。

通过自动生成接口定义,开发者可以快速为 API 响应、配置文件等数据结构创建类型定义, 避免手动编写繁琐的类型代码,提高开发效率和代码质量。

# 如何使用本工具

  1. 将 JSON 数据粘贴到左侧输入框
  2. 配置生成选项(接口名称、格式等)
  3. 工具会自动实时生成 TypeScript 接口
  4. 点击"生成 TypeScript 接口"按钮或等待自动转换
  5. 复制或下载生成的接口定义

# 支持的类型转换

基础类型

  • • string → string
  • • number → number
  • • boolean → boolean
  • • null → null | undefined
  • • undefined → undefined

复杂类型

  • • [] → T[]
  • • {} → Interface
  • • 混合数组 → Union[]
  • • 可选字段 → property?

# 高级功能

  • 智能命名: 自动推断和生成接口名称
  • 嵌套处理: 支持任意深度的嵌套对象
  • 数组类型推断: 智能推断数组元素类型
  • 联合类型: 处理不同类型的混合数组
  • 注释生成: 可选添加类型注释说明

# 转换示例

输入 JSON:

{
  "name": "John Doe",
  "age": 30,
  "isActive": true,
  "hobbies": ["reading", "coding"],
  "address": {
    "street": "123 Main St",
    "city": "New York"
  },
  "scores": [95, 88, 92]
}

输出 TypeScript:

export interface RootObject {
  name: string;
  age: number;
  isActive: boolean;
  hobbies: string[];
  address: Address;
  scores: number[];
}

export interface Address {
  street: string;
  city: string;
}

# 常见问题 (FAQ)

如何处理数组中不同类型的数据?

工具会自动检测数组中的不同类型,并生成联合类型。例如包含字符串和数字的数组会生成 (string | number)[]。

生成的接口可以直接使用吗?

可以。生成的接口遵循 TypeScript 标准语法,可以直接复制到 .ts 文件中使用。 建议根据实际需求调整属性的可选性和类型定义。

支持日期类型吗?

日期字符串会被识别为 string 类型。如果需要 Date 类型,可以在生成后手动修改, 或者使用"添加注释"选项来标记哪些字段是日期。

您可能还需要...

© 2026 星贝工具