代码生成器
页面导读
适用场景适合基于数据库表快速生成后端增删改查、前端页面和基础接口代码。
前置条件已完成数据库表设计，字段命名、主键、注释、字典、权限和菜单路径已规划。
操作路径系统工具 → 代码生成 → 导入表 → 配置字段 → 预览 → 生成代码。
验收点生成代码可编译，接口可访问，前端页面能完成列表、新增、编辑、删除和导出。
一、使用流程
二、表设计建议
| 项目 | 建议 |
|---|---|
| 表名 | 使用业务前缀，避免和系统表冲突 |
| 主键 | 统一使用平台已有主键风格 |
| 字段注释 | 必须完整，生成页面和导出会使用 |
| 状态字段 | 优先复用字典 |
| 创建更新字段 | 保持与项目通用字段一致 |
| 租户字段 | 需要隔离的数据表提前设计 |
| 逻辑删除 | 按项目统一策略设计 |
三、字段配置
| 配置项 | 说明 |
|---|---|
| Java 类型 | 后端实体字段类型 |
| 查询方式 | 等于、模糊、范围等 |
| 列表显示 | 是否在列表列展示 |
| 表单显示 | 是否在新增/编辑表单展示 |
| 必填校验 | 是否生成前端必填规则 |
| 控件类型 | 输入框、下拉框、日期、单选、多选等 |
| 字典类型 | 下拉或状态映射使用 |
四、生成后检查
- 后端包名和模块名是否正确。
- Controller 路径是否符合接口规范。
- 权限标识是否和菜单按钮一致。
- Mapper XML 是否被扫描。
- 前端 API 路径是否正确。
- 路由和菜单是否配置。
- 导入导出是否按字段注释展示。
- 新增、编辑、删除、分页查询是否通过。
五、常见问题
生成代码无法编译
检查包名、模块名、依赖模块、实体类型、Mapper 扫描路径和 Lombok 注解。
前端页面请求 404
检查后端 Controller 路径、前端 API 路径、代理前缀和菜单路由。
按钮不可见
检查菜单按钮权限、角色授权和前端权限标识。
字典不显示文本
检查字典类型是否存在、字典值是否启用、字段是否配置字典类型。
六、二次开发入口
| 类型 | 路径或接口 | 说明 |
|---|---|---|
| 前端页面 | vue3/src/views/tool/gen | 代码生成页面 |
| 后端模块 | springboot/fastbee-plugs/fastbee-generator | 代码生成核心 |
| 后端接口 | /tool/gen | 代码生成接口 |
| 数据表 | gen_table、gen_table_column | 表和字段生成配置 |
| 字典接口 | /system/dict/type、/system/dict/data | 字典配置 |