<h2>工具简介</h2>
<p><strong>SQL 转实体类</strong>是工具派推出的一款面向后端与全栈开发者的代码生成工具：只要把数据库的 <code>CREATE TABLE</code> 建表语句粘贴进去，就能自动解析出表名、字段名、字段类型、主键与是否可为空，并一键生成 <strong>Java、TypeScript、Python、Go、C#</strong> 五种语言的实体类 / 接口代码。无论是 MySQL、PostgreSQL、SQL Server 还是 SQLite 的建表语句都可以直接粘贴，支持一次解析多张表、批量生成多个实体。生成过程在浏览器本地完成解析，打开即用、无需安装，还自带一份示例 SQL，新手也能零门槛上手。</p>
<h2>功能亮点</h2>
<ul>
<li><strong>五种目标语言</strong>：同一个 SQL 可生成 Java 实体类、TypeScript 接口（interface）、Python 类、Go 结构体（struct）、C# 实体类，切换下拉框即可实时切换输出语言。</li>
<li><strong>智能类型映射</strong>：按 SQL 字段类型自动映射目标语言类型，例如 <code>BIGINT</code> → <code>Long/int64/long</code>，<code>DECIMAL</code> → <code>BigDecimal/decimal</code>，<code>DATETIME/TIMESTAMP</code> → <code>Date/time.Time/DateTime/datetime</code>，<code>VARCHAR/TEXT</code> → <code>String/string/str</code>，免去手工查表。</li>
<li><strong>多表批量解析</strong>：一次性粘贴多个 <code>CREATE TABLE</code> 语句，会按顺序生成对应的多个实体类，建库脚本可以直接整段丢进来。</li>
<li><strong>识别主键与可空性</strong>：自动识别 <code>PRIMARY KEY</code> 和 <code>NOT NULL</code> 约束——TypeScript 中可空字段自动加 <code>?</code>，Go 中可空字段生成指针类型（如 <code>*int</code>），C# 中生成可空类型（如 <code>int?</code>）。</li>
<li><strong>可选生成注解 / 标签</strong>：勾选后，Java 生成 <code>@Id</code>、<code>@Column(name = &quot;...&quot;)</code> 注解，Go 生成 <code>gorm:&quot;column:...;primaryKey&quot;</code> 标签，C# 生成 <code>[Column(&quot;...&quot;)]</code> 特性，直接对接 JPA / GORM / EF Core 等 ORM 框架。</li>
<li><strong>自动驼峰 / 帕斯卡命名</strong>：下划线字段名（如 <code>user_id</code>、<code>created_at</code>）自动转为 <code>userId</code>（Java/TS/Python 驼峰）或 <code>UserId</code>（Go/C# 帕斯卡），符合各语言命名规范。</li>
<li><strong>一键复制与下载</strong>：生成结果可一键复制到剪贴板，也可下载为对应扩展名的源码文件（<code>.java</code> / <code>.ts</code> / <code>.py</code> / <code>.go</code> / <code>.cs</code>），直接放进项目。</li>
</ul>
<h2>参数说明</h2>
<table>
<thead>
<tr>
<th>参数</th>
<th>说明</th>
<th>默认值 / 取值范围</th>
</tr>
</thead>
<tbody><tr>
<td>SQL 建表语句</td>
<td>左侧输入框，粘贴 <code>CREATE TABLE</code> 语句，支持多张表批量粘贴，支持 <code>--</code> 和 <code>/* */</code> 注释</td>
<td>默认已载入 users / orders 两张表的示例 SQL</td>
</tr>
<tr>
<td>目标语言</td>
<td>生成代码的目标语言</td>
<td>Java（默认）/ TypeScript / Python / Go / C#</td>
</tr>
<tr>
<td>生成注解 / 标签</td>
<td>勾选后输出 ORM 映射注解：Java 加 <code>@Id</code>/<code>@Column</code>，Go 加 gorm 标签，C# 加 <code>[Column]</code> 特性</td>
<td>默认不勾选</td>
</tr>
<tr>
<td>加载示例</td>
<td>按钮，将输入框内容重置为内置示例 SQL</td>
<td>点击生效</td>
</tr>
<tr>
<td>清空</td>
<td>按钮，清空输入框、生成结果与错误提示</td>
<td>点击生效</td>
</tr>
<tr>
<td>生成实体类</td>
<td>主按钮，解析 SQL 并生成实体代码，输入为空时禁用</td>
<td>无输入时不可点击</td>
</tr>
<tr>
<td>复制 / 下载</td>
<td>结果区按钮，复制到剪贴板或下载为 <code>entities.&lt;扩展名&gt;</code> 文件</td>
<td>有生成结果后可用</td>
</tr>
<tr>
<td>刷新额度</td>
<td>结果区按钮，刷新当前账号的剩余免费额度</td>
<td>点击生效</td>
</tr>
</tbody></table>
<h2>使用步骤</h2>
<ol>
<li><strong>打开工具页面</strong>：左侧是 SQL 输入区与生成选项，右侧是生成结果区，页面顶部显示工具名称和当前账号的免费额度，登录后即可使用。</li>
</ol>
<p><img src="article/202607/1783996876835_4527.png" alt="SQL 转实体类主界面：顶部为工具标题与会员横幅，左侧为「SQL 建表语句」输入卡片，内含已载入 users/order"></p>
<ol start="2">
<li><p><strong>粘贴建表语句</strong>：把数据库导出的 <code>CREATE TABLE</code> 语句粘贴到左侧「SQL 建表语句」输入框。没有现成语句时，先点右上角「加载示例」看看内置的 users、orders 两张表演示效果；想重来时点「清空」。</p>
</li>
<li><p><strong>选择目标语言</strong>：在「目标语言」下拉框中选择 Java、TypeScript、Python、Go 或 C#，默认是 Java。</p>
</li>
<li><p><strong>按需勾选注解（可选）</strong>：如果项目使用 JPA / MyBatis-Plus、GORM 或 EF Core 等 ORM 框架，勾选「生成注解 / 标签」，生成的代码会带上字段映射注解，省去手工添加；只要纯 POJO / 纯结构体则保持不勾选。</p>
</li>
<li><p><strong>点击「生成实体类」</strong>：工具会校验输入——为空时提示「请输入 SQL 建表语句」，解析不到建表语句时提示「未解析到有效的 CREATE TABLE 语句」；解析成功后右侧结果区立即显示生成的代码，多张表会生成多个实体。</p>
</li>
<li><p><strong>复制或下载结果</strong>：确认结果后点「复制」粘贴到 IDE，或点「下载」得到 <code>entities.java</code> / <code>entities.ts</code> / <code>entities.py</code> / <code>entities.go</code> / <code>entities.cs</code> 文件，扩展名随目标语言自动匹配。</p>
</li>
</ol>
<h2>使用技巧</h2>
<ul>
<li><strong>整段建库脚本直接粘贴</strong>：解析器会跳过 <code>PRIMARY KEY(...)</code>、<code>KEY</code>、<code>INDEX</code>、<code>CONSTRAINT</code>、<code>FOREIGN KEY</code> 等约束行，也会自动去掉 <code>--</code> 和 <code>/* */</code> 注释，所以从数据库工具导出的完整 DDL 脚本可以原样粘贴，无需手工清理。</li>
<li><strong>善用类型映射规则</strong>：想让某个字段生成字符串类型，就用 <code>VARCHAR/TEXT/JSON</code>；想生成大数用 <code>BIGINT</code>，金额用 <code>DECIMAL</code> 会自动映射为 <code>BigDecimal/decimal</code> 等高精度类型。</li>
<li><strong>可空性要标对</strong>：加上 <code>NOT NULL</code> 的字段在 TypeScript 中不带 <code>?</code>、在 Go/C# 中不生成指针 / 可空类型，所以建表语句的约束写得越规范，生成的实体越贴合业务。</li>
<li><strong>Go 项目记得勾选注解</strong>：勾选后会自动生成 <code>gorm:&quot;column:user_id;primaryKey&quot;</code> 这样的标签，直接可以被 GORM 识别；同时工具会在用到时间类型时自动补上 <code>import &quot;time&quot;</code>。</li>
<li><strong>C# 项目同理</strong>：勾选注解后会自动添加 <code>using System.ComponentModel.DataAnnotations.Schema;</code> 引用，用到 <code>DateTime</code> 时也会自动补 <code>using System;</code>，生成的文件基本可以直接编译。</li>
<li><strong>字段命名用下划线风格</strong>：工具会把 <code>created_at</code> 这类 snake_case 字段自动转成各语言惯例的命名（<code>createdAt</code> / <code>CreatedAt</code>），所以数据库保持下划线命名即可，不需要为了代码风格改库表设计。</li>
</ul>
<h2>常见问题</h2>
<p><strong>Q1：支持哪些数据库的建表语句？</strong><br>只要符合标准 <code>CREATE TABLE 表名 (...)</code> 语法即可，MySQL、PostgreSQL、SQL Server、SQLite 的常用写法都支持，包括带反引号 / 引号的表名和字段名、<code>IF NOT EXISTS</code>、<code>ENGINE</code>、<code>CHARSET</code>、<code>COMMENT</code> 等后缀。</p>
<p><strong>Q2：为什么有些字段没有出现在生成结果里？</strong><br>以 <code>PRIMARY KEY(...)</code>、<code>UNIQUE(</code>、<code>KEY</code>、<code>INDEX</code>、<code>CONSTRAINT</code>、<code>FOREIGN KEY</code> 开头的约束行会被当作表级约束跳过，这是正常行为；如果某个普通字段也没解析出来，检查它是否是 <code>字段名 类型</code> 的标准格式（类型可带括号，如 <code>VARCHAR(64)</code>）。</p>
<p><strong>Q3：生成的 Java 类为什么没有 getter/setter？</strong><br>生成结果中字段后附有 <code>// getters and setters...</code> 占位注释，具体方法建议用 IDE（如 IntelliJ 的 Generate）或 Lombok 的 <code>@Data</code> 注解自动生成，比工具硬编码更灵活。</p>
<p><strong>Q4：SQL 里的注释会影响生成吗？</strong><br>不会。解析前会自动移除 <code>--</code> 单行注释和 <code>/* */</code> 块注释，带注释的建表脚本可以直接粘贴。</p>
<p><strong>Q5：可以一次生成多张表的实体吗？</strong><br>可以。粘贴多个 <code>CREATE TABLE</code> 语句，工具会依次解析并生成多个实体类，按表顺序拼接在同一份输出里，复制或下载一次即可全部带走。</p>
<p><strong>Q6：下载的文件名为什么是 entities.xxx 而不是表名？</strong><br>下载时按目标语言统一命名为 <code>entities.java</code> / <code>entities.ts</code> / <code>entities.py</code> / <code>entities.go</code> / <code>entities.cs</code>，下载后可以自行重命名或按类名拆分成多个文件。</p>


## 工具简介

**SQL 转实体类**是工具派推出的一款面向后端与全栈开发者的代码生成工具：只要把数据库的 `CREATE TABLE` 建表语句粘贴进去，就能自动解析出表名、字段名、字段类型、主键与是否可为空，并一键生成 **Java、TypeScript、Python、Go、C#** 五种语言的实体类 / 接口代码。无论是 MySQL、PostgreSQL、SQL Server 还是 SQLite 的建表语句都可以直接粘贴，支持一次解析多张表、批量生成多个实体。生成过程在浏览器本地完成解析，打开即用、无需安装，还自带一份示例 SQL，新手也能零门槛上手。

## 功能亮点

- **五种目标语言**：同一个 SQL 可生成 Java 实体类、TypeScript 接口（interface）、Python 类、Go 结构体（struct）、C# 实体类，切换下拉框即可实时切换输出语言。
- **智能类型映射**：按 SQL 字段类型自动映射目标语言类型，例如 `BIGINT` → `Long/int64/long`，`DECIMAL` → `BigDecimal/decimal`，`DATETIME/TIMESTAMP` → `Date/time.Time/DateTime/datetime`，`VARCHAR/TEXT` → `String/string/str`，免去手工查表。
- **多表批量解析**：一次性粘贴多个 `CREATE TABLE` 语句，会按顺序生成对应的多个实体类，建库脚本可以直接整段丢进来。
- **识别主键与可空性**：自动识别 `PRIMARY KEY` 和 `NOT NULL` 约束——TypeScript 中可空字段自动加 `?`，Go 中可空字段生成指针类型（如 `*int`），C# 中生成可空类型（如 `int?`）。
- **可选生成注解 / 标签**：勾选后，Java 生成 `@Id`、`@Column(name = "...")` 注解，Go 生成 `gorm:"column:...;primaryKey"` 标签，C# 生成 `[Column("...")]` 特性，直接对接 JPA / GORM / EF Core 等 ORM 框架。
- **自动驼峰 / 帕斯卡命名**：下划线字段名（如 `user_id`、`created_at`）自动转为 `userId`（Java/TS/Python 驼峰）或 `UserId`（Go/C# 帕斯卡），符合各语言命名规范。
- **一键复制与下载**：生成结果可一键复制到剪贴板，也可下载为对应扩展名的源码文件（`.java` / `.ts` / `.py` / `.go` / `.cs`），直接放进项目。

## 参数说明

| 参数 | 说明 | 默认值 / 取值范围 |
| --- | --- | --- |
| SQL 建表语句 | 左侧输入框，粘贴 `CREATE TABLE` 语句，支持多张表批量粘贴，支持 `--` 和 `/* */` 注释 | 默认已载入 users / orders 两张表的示例 SQL |
| 目标语言 | 生成代码的目标语言 | Java（默认）/ TypeScript / Python / Go / C# |
| 生成注解 / 标签 | 勾选后输出 ORM 映射注解：Java 加 `@Id`/`@Column`，Go 加 gorm 标签，C# 加 `[Column]` 特性 | 默认不勾选 |
| 加载示例 | 按钮，将输入框内容重置为内置示例 SQL | 点击生效 |
| 清空 | 按钮，清空输入框、生成结果与错误提示 | 点击生效 |
| 生成实体类 | 主按钮，解析 SQL 并生成实体代码，输入为空时禁用 | 无输入时不可点击 |
| 复制 / 下载 | 结果区按钮，复制到剪贴板或下载为 `entities.<扩展名>` 文件 | 有生成结果后可用 |
| 刷新额度 | 结果区按钮，刷新当前账号的剩余免费额度 | 点击生效 |

## 使用步骤

1. **打开工具页面**：左侧是 SQL 输入区与生成选项，右侧是生成结果区，页面顶部显示工具名称和当前账号的免费额度，登录后即可使用。

![SQL 转实体类主界面：顶部为工具标题与会员横幅，左侧为「SQL 建表语句」输入卡片，内含已载入 users/order](article/202607/1783996876835_4527.png)

2. **粘贴建表语句**：把数据库导出的 `CREATE TABLE` 语句粘贴到左侧「SQL 建表语句」输入框。没有现成语句时，先点右上角「加载示例」看看内置的 users、orders 两张表演示效果；想重来时点「清空」。

3. **选择目标语言**：在「目标语言」下拉框中选择 Java、TypeScript、Python、Go 或 C#，默认是 Java。

4. **按需勾选注解（可选）**：如果项目使用 JPA / MyBatis-Plus、GORM 或 EF Core 等 ORM 框架，勾选「生成注解 / 标签」，生成的代码会带上字段映射注解，省去手工添加；只要纯 POJO / 纯结构体则保持不勾选。

5. **点击「生成实体类」**：工具会校验输入——为空时提示「请输入 SQL 建表语句」，解析不到建表语句时提示「未解析到有效的 CREATE TABLE 语句」；解析成功后右侧结果区立即显示生成的代码，多张表会生成多个实体。

6. **复制或下载结果**：确认结果后点「复制」粘贴到 IDE，或点「下载」得到 `entities.java` / `entities.ts` / `entities.py` / `entities.go` / `entities.cs` 文件，扩展名随目标语言自动匹配。

## 使用技巧

- **整段建库脚本直接粘贴**：解析器会跳过 `PRIMARY KEY(...)`、`KEY`、`INDEX`、`CONSTRAINT`、`FOREIGN KEY` 等约束行，也会自动去掉 `--` 和 `/* */` 注释，所以从数据库工具导出的完整 DDL 脚本可以原样粘贴，无需手工清理。
- **善用类型映射规则**：想让某个字段生成字符串类型，就用 `VARCHAR/TEXT/JSON`；想生成大数用 `BIGINT`，金额用 `DECIMAL` 会自动映射为 `BigDecimal/decimal` 等高精度类型。
- **可空性要标对**：加上 `NOT NULL` 的字段在 TypeScript 中不带 `?`、在 Go/C# 中不生成指针 / 可空类型，所以建表语句的约束写得越规范，生成的实体越贴合业务。
- **Go 项目记得勾选注解**：勾选后会自动生成 `gorm:"column:user_id;primaryKey"` 这样的标签，直接可以被 GORM 识别；同时工具会在用到时间类型时自动补上 `import "time"`。
- **C# 项目同理**：勾选注解后会自动添加 `using System.ComponentModel.DataAnnotations.Schema;` 引用，用到 `DateTime` 时也会自动补 `using System;`，生成的文件基本可以直接编译。
- **字段命名用下划线风格**：工具会把 `created_at` 这类 snake_case 字段自动转成各语言惯例的命名（`createdAt` / `CreatedAt`），所以数据库保持下划线命名即可，不需要为了代码风格改库表设计。

## 常见问题

**Q1：支持哪些数据库的建表语句？**
只要符合标准 `CREATE TABLE 表名 (...)` 语法即可，MySQL、PostgreSQL、SQL Server、SQLite 的常用写法都支持，包括带反引号 / 引号的表名和字段名、`IF NOT EXISTS`、`ENGINE`、`CHARSET`、`COMMENT` 等后缀。

**Q2：为什么有些字段没有出现在生成结果里？**
以 `PRIMARY KEY(...)`、`UNIQUE(`、`KEY`、`INDEX`、`CONSTRAINT`、`FOREIGN KEY` 开头的约束行会被当作表级约束跳过，这是正常行为；如果某个普通字段也没解析出来，检查它是否是 `字段名 类型` 的标准格式（类型可带括号，如 `VARCHAR(64)`）。

**Q3：生成的 Java 类为什么没有 getter/setter？**
生成结果中字段后附有 `// getters and setters...` 占位注释，具体方法建议用 IDE（如 IntelliJ 的 Generate）或 Lombok 的 `@Data` 注解自动生成，比工具硬编码更灵活。

**Q4：SQL 里的注释会影响生成吗？**
不会。解析前会自动移除 `--` 单行注释和 `/* */` 块注释，带注释的建表脚本可以直接粘贴。

**Q5：可以一次生成多张表的实体吗？**
可以。粘贴多个 `CREATE TABLE` 语句，工具会依次解析并生成多个实体类，按表顺序拼接在同一份输出里，复制或下载一次即可全部带走。

**Q6：下载的文件名为什么是 entities.xxx 而不是表名？**
下载时按目标语言统一命名为 `entities.java` / `entities.ts` / `entities.py` / `entities.go` / `entities.cs`，下载后可以自行重命名或按类名拆分成多个文件。


免费在线 SQL 转实体类工具，粘贴 CREATE TABLE 语句即可生成 Java、TypeScript、Python、Go、C# 五种语言的实体类代码。支持多表批量解析、智能类型映射、主键与可空识别，可选生成 JPA / GORM / EF Core 注解，一键复制或下载源码文件。

SQL 转实体类使用教程：粘贴 CREATE TABLE 一键生成 Java/TS/Python 实体代码