<h2>工具简介</h2>
<p><strong>JSON 转多语言实体类</strong>是工具派面向开发者的一款代码生成工具：把接口返回的 JSON 粘贴到左侧输入框，选择目标语言并点击「生成实体类」，右侧就会得到对应语言的实体类代码——Java Class、Python dataclass、TypeScript interface、Go struct、C# Class、Dart、Rust、Swift、Kotlin、PHP、Ruby 共 11 种语言全覆盖。工具会自动推断字段类型、把嵌套对象和对象数组拆成独立的子类，并按各语言惯例转换命名，生成结果可一键复制，全程在浏览器本地运行，打开即用、无需安装。</p>
<h2>功能亮点</h2>
<ul>
<li><strong>11 种目标语言</strong>：Java、Python、TypeScript、Go、C#、Dart、Rust、Swift、Kotlin、PHP、Ruby，输出均为各语言惯用结构——Rust 自动带 serde 派生与 rename 注解、Kotlin 生成 data class、Swift 遵循 Codable、Python 生成 @dataclass。</li>
<li><strong>自动类型推断</strong>：字符串、整数、小数、布尔、null 分别映射为各语言对应类型；整数与小数会区分成 int / double（Go 中为 int / float64）等不同精度。</li>
<li><strong>嵌套结构自动拆类</strong>：JSON 中的嵌套对象会递归生成独立子类；对象数组会以元素类型生成「列表&lt;子类&gt;」形式的字段，数组键名会智能去掉尾部 s 作为子类名。</li>
<li><strong>三个生成选项</strong>：Java 专属「Lombok」勾选后省略 getter/setter 并附 @Data 注释；「可空」让 TypeScript 字段加 <code>?</code>、Go 标签加 omitempty、Dart/Kotlin 类型加 <code>?</code>；「JSON 注解」为 Go 结构体生成 <code>json:&quot;字段名&quot;</code> 标签（默认开启）。</li>
<li><strong>规范化命名转换</strong>：Java / Dart / Kotlin / Swift 字段转为 camelCase，Rust 字段转为 snake_case 并保留原名做 serde rename，Go / C# 属性转为 PascalCase，Python 保持原始字段名。</li>
<li><strong>一键复制 + 容错提示</strong>：结果区右上角「复制」按钮一键带走全部代码；JSON 格式错误时给出红色提示「JSON 解析失败，请检查输入」，根节点不是对象时也会在输出中说明推断类型。</li>
</ul>
<h2>参数说明</h2>
<table>
<thead>
<tr>
<th>参数</th>
<th>说明</th>
<th>默认值 / 取值范围</th>
</tr>
</thead>
<tbody><tr>
<td>语言下拉框</td>
<td>选择要生成的目标语言</td>
<td>Java（默认）/ Python / TypeScript / Go / C# / Dart / Rust / Swift / Kotlin / PHP / Ruby</td>
</tr>
<tr>
<td>根类名</td>
<td>最外层类的名称；嵌套子类的类名由字段名自动生成</td>
<td>默认 Root</td>
</tr>
<tr>
<td>Lombok</td>
<td>仅 Java 可见：勾选后类中不再生成 getter/setter，改为标注 <code>// Lombok: @Data</code> 注释</td>
<td>默认不勾选</td>
</tr>
<tr>
<td>可空</td>
<td>TypeScript 字段追加 <code>?</code>；Go 的 json 标签追加 <code>,omitempty</code>；Dart / Kotlin 类型追加 <code>?</code></td>
<td>默认不勾选</td>
</tr>
<tr>
<td>JSON 注解</td>
<td>Go 结构体字段生成 <code>json:&quot;原字段名&quot;</code> 标签</td>
<td>默认勾选</td>
</tr>
<tr>
<td>输入 JSON</td>
<td>待转换的 JSON 文本，页面自带一段示例</td>
<td>默认示例 <code>{name, age, vip, tags}</code></td>
</tr>
</tbody></table>
<h2>使用步骤</h2>
<ol>
<li><strong>打开工具页面</strong>：左侧是「输入 JSON」编辑区，右侧是「生成代码」结果区，顶部是语言、类名与选项行，页面已预置一段示例 JSON。</li>
</ol>
<p><img src="article/202607/1783968752649_4774.png" alt="JSON 转多语言实体类主界面：顶部为语言下拉框（默认 Java）、根类名输入框（默认 Root）和 Lombok/可空"></p>
<ol start="2">
<li><p><strong>粘贴或编写 JSON</strong>：在左侧输入框粘贴接口返回的 JSON。默认示例中 <code>name</code> 为字符串、<code>age</code> 为整数、<code>vip</code> 为布尔、<code>tags</code> 为字符串数组，正好覆盖四种基础类型。</p>
</li>
<li><p><strong>选择目标语言与类名</strong>：在左上下拉框选择语言（如 Java），在「根类名」输入框填写最外层类名（默认 Root）。</p>
</li>
<li><p><strong>按需勾选生成选项</strong>：Java 下可勾选「Lombok」省略 getter/setter；需要可选字段时勾选「可空」；生成 Go 结构体时保持「JSON 注解」勾选以输出 json 标签。</p>
</li>
<li><p><strong>点击「生成实体类」</strong>：右侧结果区立即生成对应语言代码。嵌套对象会拆成独立子类排在根类之前，<code>tags</code> 这样的数组字段会生成 <code>List&lt;String&gt;</code>（Java）之类的列表类型。</p>
</li>
<li><p><strong>复制使用</strong>：确认结果后点击结果区右上角「复制」，粘贴到项目源码中即可。</p>
</li>
</ol>
<h2>使用技巧</h2>
<ul>
<li><strong>对象数组的子类名会自动「单数化」</strong>：字段 <code>users</code> 对应的子类名会去掉尾部 s 变成 User，起字段名时用复数能让生成的类名更自然。</li>
<li><strong>空数组与 null 会退化为通用类型</strong>：空数组推断为「任意类型列表」，null 推断为 Object / any / interface{} 等，生成后记得按实际情况手工收窄类型。</li>
<li><strong>整数与小数分开处理</strong>：<code>3</code> 会生成 int 类类型，<code>3.5</code> 会生成 double / float64，若接口实际返回浮点金额，示例数据里写成小数能让推断类型更准确。</li>
<li><strong>Go 项目保持「JSON 注解」开启</strong>：生成 <code>json:&quot;user_id&quot;</code> 标签后，字段名即使转为 PascalCase 也能正确反序列化；配合「可空」还能加上 omitempty，适合精简响应体。</li>
<li><strong>根节点必须是对象</strong>：如果 JSON 顶层是数组，工具会取第一个元素生成；顶层是字符串、数字等标量时无法生成实体类，会在输出中给出提示。</li>
</ul>
<h2>常见问题</h2>
<p><strong>Q1：支持哪些语言？生成的是什么结构？</strong><br>共 11 种：Java Class（getter/setter 或 Lombok）、Python @dataclass、TypeScript interface、Go struct、C# Class（<code>{ get; set; }</code>）、Dart final 字段 + 构造器、Rust serde struct、Swift Codable struct、Kotlin data class、PHP Class、Ruby attr_accessor 类。</p>
<p><strong>Q2：「可空」选项具体影响哪些语言？</strong><br>TypeScript 字段名后加 <code>?</code> 表示可选；Go 的 json 标签追加 <code>,omitempty</code>；Dart 和 Kotlin 的类型后加 <code>?</code> 表示可空。其余语言该选项不影响输出。</p>
<p><strong>Q3：嵌套对象和数组会生成几个类？</strong><br>每个嵌套对象、每个对象数组都会各自生成一个独立子类，子类代码排在根类之前；子类类名由字段名做 PascalCase 转换得到（对象数组会先去尾部 s）。</p>
<p><strong>Q4：提示「JSON 解析失败」怎么办？</strong><br>说明输入不是合法 JSON，常见原因是多了尾随逗号、用了单引号或混入了注释。先用 JSON 校验工具格式化一遍再粘贴即可。</p>
<p><strong>Q5：生成的字段顺序和原 JSON 一致吗？</strong><br>一致。工具按 JSON 对象中键的出现顺序生成字段，子类按遇到的先后顺序依次排列在根类前面。</p>


## 工具简介

**JSON 转多语言实体类**是工具派面向开发者的一款代码生成工具：把接口返回的 JSON 粘贴到左侧输入框，选择目标语言并点击「生成实体类」，右侧就会得到对应语言的实体类代码——Java Class、Python dataclass、TypeScript interface、Go struct、C# Class、Dart、Rust、Swift、Kotlin、PHP、Ruby 共 11 种语言全覆盖。工具会自动推断字段类型、把嵌套对象和对象数组拆成独立的子类，并按各语言惯例转换命名，生成结果可一键复制，全程在浏览器本地运行，打开即用、无需安装。

## 功能亮点

- **11 种目标语言**：Java、Python、TypeScript、Go、C#、Dart、Rust、Swift、Kotlin、PHP、Ruby，输出均为各语言惯用结构——Rust 自动带 serde 派生与 rename 注解、Kotlin 生成 data class、Swift 遵循 Codable、Python 生成 @dataclass。
- **自动类型推断**：字符串、整数、小数、布尔、null 分别映射为各语言对应类型；整数与小数会区分成 int / double（Go 中为 int / float64）等不同精度。
- **嵌套结构自动拆类**：JSON 中的嵌套对象会递归生成独立子类；对象数组会以元素类型生成「列表<子类>」形式的字段，数组键名会智能去掉尾部 s 作为子类名。
- **三个生成选项**：Java 专属「Lombok」勾选后省略 getter/setter 并附 @Data 注释；「可空」让 TypeScript 字段加 `?`、Go 标签加 omitempty、Dart/Kotlin 类型加 `?`；「JSON 注解」为 Go 结构体生成 `json:"字段名"` 标签（默认开启）。
- **规范化命名转换**：Java / Dart / Kotlin / Swift 字段转为 camelCase，Rust 字段转为 snake_case 并保留原名做 serde rename，Go / C# 属性转为 PascalCase，Python 保持原始字段名。
- **一键复制 + 容错提示**：结果区右上角「复制」按钮一键带走全部代码；JSON 格式错误时给出红色提示「JSON 解析失败，请检查输入」，根节点不是对象时也会在输出中说明推断类型。

## 参数说明

| 参数 | 说明 | 默认值 / 取值范围 |
| --- | --- | --- |
| 语言下拉框 | 选择要生成的目标语言 | Java（默认）/ Python / TypeScript / Go / C# / Dart / Rust / Swift / Kotlin / PHP / Ruby |
| 根类名 | 最外层类的名称；嵌套子类的类名由字段名自动生成 | 默认 Root |
| Lombok | 仅 Java 可见：勾选后类中不再生成 getter/setter，改为标注 `// Lombok: @Data` 注释 | 默认不勾选 |
| 可空 | TypeScript 字段追加 `?`；Go 的 json 标签追加 `,omitempty`；Dart / Kotlin 类型追加 `?` | 默认不勾选 |
| JSON 注解 | Go 结构体字段生成 `json:"原字段名"` 标签 | 默认勾选 |
| 输入 JSON | 待转换的 JSON 文本，页面自带一段示例 | 默认示例 `{name, age, vip, tags}` |

## 使用步骤

1. **打开工具页面**：左侧是「输入 JSON」编辑区，右侧是「生成代码」结果区，顶部是语言、类名与选项行，页面已预置一段示例 JSON。

![JSON 转多语言实体类主界面：顶部为语言下拉框（默认 Java）、根类名输入框（默认 Root）和 Lombok/可空](article/202607/1783968752649_4774.png)

2. **粘贴或编写 JSON**：在左侧输入框粘贴接口返回的 JSON。默认示例中 `name` 为字符串、`age` 为整数、`vip` 为布尔、`tags` 为字符串数组，正好覆盖四种基础类型。

3. **选择目标语言与类名**：在左上下拉框选择语言（如 Java），在「根类名」输入框填写最外层类名（默认 Root）。

4. **按需勾选生成选项**：Java 下可勾选「Lombok」省略 getter/setter；需要可选字段时勾选「可空」；生成 Go 结构体时保持「JSON 注解」勾选以输出 json 标签。

5. **点击「生成实体类」**：右侧结果区立即生成对应语言代码。嵌套对象会拆成独立子类排在根类之前，`tags` 这样的数组字段会生成 `List<String>`（Java）之类的列表类型。

6. **复制使用**：确认结果后点击结果区右上角「复制」，粘贴到项目源码中即可。

## 使用技巧

- **对象数组的子类名会自动「单数化」**：字段 `users` 对应的子类名会去掉尾部 s 变成 User，起字段名时用复数能让生成的类名更自然。
- **空数组与 null 会退化为通用类型**：空数组推断为「任意类型列表」，null 推断为 Object / any / interface{} 等，生成后记得按实际情况手工收窄类型。
- **整数与小数分开处理**：`3` 会生成 int 类类型，`3.5` 会生成 double / float64，若接口实际返回浮点金额，示例数据里写成小数能让推断类型更准确。
- **Go 项目保持「JSON 注解」开启**：生成 `json:"user_id"` 标签后，字段名即使转为 PascalCase 也能正确反序列化；配合「可空」还能加上 omitempty，适合精简响应体。
- **根节点必须是对象**：如果 JSON 顶层是数组，工具会取第一个元素生成；顶层是字符串、数字等标量时无法生成实体类，会在输出中给出提示。

## 常见问题

**Q1：支持哪些语言？生成的是什么结构？**
共 11 种：Java Class（getter/setter 或 Lombok）、Python @dataclass、TypeScript interface、Go struct、C# Class（`{ get; set; }`）、Dart final 字段 + 构造器、Rust serde struct、Swift Codable struct、Kotlin data class、PHP Class、Ruby attr_accessor 类。

**Q2：「可空」选项具体影响哪些语言？**
TypeScript 字段名后加 `?` 表示可选；Go 的 json 标签追加 `,omitempty`；Dart 和 Kotlin 的类型后加 `?` 表示可空。其余语言该选项不影响输出。

**Q3：嵌套对象和数组会生成几个类？**
每个嵌套对象、每个对象数组都会各自生成一个独立子类，子类代码排在根类之前；子类类名由字段名做 PascalCase 转换得到（对象数组会先去尾部 s）。

**Q4：提示「JSON 解析失败」怎么办？**
说明输入不是合法 JSON，常见原因是多了尾随逗号、用了单引号或混入了注释。先用 JSON 校验工具格式化一遍再粘贴即可。

**Q5：生成的字段顺序和原 JSON 一致吗？**
一致。工具按 JSON 对象中键的出现顺序生成字段，子类按遇到的先后顺序依次排列在根类前面。


JSON 转多语言实体类工具使用教程：粘贴 JSON 选择语言即可生成 Java、Python、TypeScript、Go 等 11 种语言实体类代码，支持 Lombok、可空字段、Go json 注解，嵌套对象自动拆分子类，一键复制。

JSON 转多语言实体类教程：粘贴 JSON 一键生成 Java/Python/Go 等 11 种语言实体类