# JSON 转 TypeScript 接口在线生成 - JSON 转 Go 结构体

> 免费在线 JSON 转 TypeScript：根据 JSON 生成 interface 或 type，嵌套对象拆成命名接口，数组元素合并并推断可选字段，也可生成 Go struct。

- 网址: https://qilingtools.com/zh/json-to-ts
- 分类: 开发工具 (https://qilingtools.com/zh/dev)
- 标签: [格式转换](https://qilingtools.com/zh/tags/convert), [开发](https://qilingtools.com/zh/tags/dev), [数据格式](https://qilingtools.com/zh/tags/data)
- 最后更新: 2026-10-26
- 价格: 免费，无需注册
- 隐私: 在浏览器本地处理，文件不上传服务器

对接接口时，把后端返回的 JSON 示例粘进来，就能自动得到对应的 TypeScript 类型定义，省去手写 interface 的麻烦。嵌套对象会拆成独立的命名接口（名称取自字段名，数组元素自动转单数），数组里多个元素的结构会合并，某些元素缺少的字段自动标记为可选（?），数字、字符串混合的数组生成联合类型。可选择 interface 或 type 写法、是否 export；切换到 Go 标签页还能生成带 `json:"..."` tag 的 Go struct，字段名自动转成驼峰并处理 ID、URL 等缩写。全部在浏览器本地完成。

## 使用步骤

1. 粘贴接口返回的 JSON（对象或数组）
2. 设置根类型名，选择 interface / type、是否 export，或切到 Go struct
3. 复制右侧生成的类型定义，粘贴到项目里

## 功能特点

- 嵌套对象自动拆分为命名 interface
- 数组元素结构合并，缺失字段标记为可选
- 混合类型数组生成联合类型，如 (number | string)[]
- interface / type 两种写法，可选 export
- 非法标识符的键名自动加引号
- 结构相同的对象复用同一个类型
- 一键生成 Go struct，json tag、omitempty、ID/URL 缩写规范
- 本地生成，数据不上传

## 常见问题

### 字段什么时候会被标记为可选？

当 JSON 数组里有多个对象、某个字段只在部分对象里出现时，该字段会标记为可选（key?: type）。勾选"null 字段视为可选"后，值为 null 的字段也会标记为可选。

### 生成的接口名是怎么来的？

根类型使用你填写的名字，嵌套对象用字段名转成大驼峰（如 user_profile → UserProfile），数组元素会去掉复数（items → Item）。重名时自动加数字后缀，结构完全相同的对象会共用一个类型。

### Go struct 里的数字是 int 还是 float？

整数推断为 int64，带小数的推断为 float64；同一字段既有整数又有小数时取 float64。可为 null 的字段会生成指针类型，便于区分零值与缺失。

### 数据会上传到服务器吗？

不会。所有处理都在你的浏览器本地完成，没有任何网络上传，关闭页面即清除，可以放心处理公司内部数据。

## 相关工具

- [JSON 格式化](https://qilingtools.com/zh/json): 免费在线 JSON 格式化：一键美化、压缩，实时语法校验并定位到出错行列，支持树形视图折叠、键名排序、转义与去转义、Unicode 转中文、复制下载，数据不上传。
- [Base64 编解码](https://qilingtools.com/zh/base64): 免费在线 Base64 编码解码工具：支持中文 UTF-8、URL 安全变体，文本与 Base64 互转，实时转换，本地处理不上传。
- [URL 编解码](https://qilingtools.com/zh/url-encode): 免费在线 URL 编码解码工具：encodeURIComponent 与 encodeURI 两种模式，处理中文、空格与特殊符号，本地实时转换不上传。
- [JWT 解析](https://qilingtools.com/zh/jwt): 免费在线 JWT 解析工具：解码 JWT 的 Header 与 Payload，展示过期时间、签发时间等，本地解析不上传，保护令牌安全。
- [时间戳转换](https://qilingtools.com/zh/timestamp): 免费在线 Unix 时间戳转换工具：时间戳与日期互转，自动识别秒/毫秒，显示本地时间、UTC、ISO 8601 和相对时间，实时更新。
- [哈希计算](https://qilingtools.com/zh/hash): 免费在线哈希/摘要计算工具：对文本或文件计算 SHA-1、SHA-256、SHA-384、SHA-512，使用浏览器加密接口本地完成，文件不上传。
- [UUID 生成](https://qilingtools.com/zh/uuid): 免费在线 UUID 生成器：使用加密安全随机数批量生成符合 RFC 4122 的 UUID v4，可大写、去连字符、加花括号，一键复制。
- [进制转换](https://qilingtools.com/zh/base-convert): 免费在线进制转换工具：二进制、八进制、十进制、十六进制及任意 2–36 进制互转，支持大整数（BigInt），本地实时计算。