第 17 章 代码生成器

学习目标

学完本章，你应该能：

1. 理解代码生成器的作用和价值
2. 掌握自动模式和纯手动模式两种用法
3. 知道生成代码后的注意事项

一、代码生成器是什么

fba 内置了代码生成器，能根据数据库表自动生成一套完整的增删改查代码（model、schema、crud、service、router）。

对于后台管理这类重复性很高的模块，代码生成器能省大量时间。

社区评价：

"代码生成挺省心，尤其是后台管理这类重复模块。"

代码生成器能生成什么

二、两个模块

代码生成器包含两个概念模块：

模块	作用
业务	代码生成的相关配置（模块名、路径等）
模型	要生成的表对应的列信息

注意：代码生成器目前只支持后端工程，不生成前端代码。

三、两种使用模式

方式一：自动模式（推荐）

根据已有的数据库表自动生成代码：

1. 访问 tables 接口，获取数据库表名列表
2. 通过 imports 接口，导入数据库已有的表（自动创建业务和模型数据）
3. 访问预览、磁盘写入、下载接口，执行代码生成

自动模式流程

方式二：纯手动模式（不推荐）

手动创建业务和模型：

1. 通过"创建业务"接口手动添加业务数据
2. 通过"模型创建"接口手动添加模型列
3. 访问预览、写入、下载接口生成代码

纯手动模式已被标记为"已弃用"，优先用自动模式。

四、如何使用

代码生成器通过 API 调用使用，三种操作方式：

1. Swagger 文档：启动后端，打开 /docs 直接操作
2. API 调试工具：用 Postman 等工具发送请求
3. 前端页面：同时启动前后端，在管理界面操作

接口参数基本都有说明，操作时注意查看。

五、重要提醒：生成后要复核

官方特别强调：

代码生成后仍建议结合 fba skills 复核分层命名、响应模型、分页、事务、权限和格式化结果，不要把生成结果直接视为最终代码。

生成器生成的代码是"骨架"，可能不完全符合你的业务需求，需要人工检查和调整。

正确使用姿势

六、常见疑问

Q1：代码生成器适合什么场景？ 最适合后台管理这类"标准增删改查"的模块，能省大量重复劳动。复杂业务逻辑仍需手写。

Q2：为什么不生成前端代码？ 目前官方只实现了后端代码生成。前端代码因组件、样式差异大，生成效果不理想，暂不支持。

本章小结

关键要点回顾：

• 代码生成器根据数据库表自动生成增删改查代码
• 自动模式：tables → imports → 预览/写入/下载
• 只支持后端，不生成前端
• 生成后务必人工复核，不能直接当最终代码

下一步： 第 18 章讲 AI 辅助开发，让 AI 工具读懂项目规范。

---

对应官方文档：代码生成（backend/reference/code-generation.html）