AI开发实战5、手摸手教学：如何用AI+go-zero，从数据库设计开始构建API
这篇文章是从 0 到 1 使用 AI 开发完整项目的第 5 篇文章，也是讲解用 AI 开发后端 API 接口的第一篇文章。 关于用 AI 来开发 API 接口的文章不会讲太多，因为其实大部分的框架部分最好还是自己写，用 AI 来辅助为好，当你把项目框架写清楚之后，简单的业务逻辑部分就可以直接交给 AI，让 AI 在你限定的框架之下去编程，这样不仅可以高效率的写代码而且还可以很好的保证代码风格的一致性。 好了，废话就不多说了。 直接拿我最近刚刚撸完的一个开源项目——Momento（时光账记） 后端 API 为例，手把手教大家如何利用 AI（Claude 3.5 Sonnet / Gemini Pro 等模型）从 0 到 1 构建一个高性能的 Go 微服务后端。 在讲解之前，先简单介绍一下时光账记小程序： 时光账记是一款基于 这是一款专注于个人财务管理与生活记录的应用。它不仅支持非常简洁的方式来管理基础的收支记录，还提供了多账本管理、周期性自动记账、预算控制以及节日倒计时等贴心功能，帮助用户更好地管理个人及家庭财务。 现在我已将代码都开源了，感兴趣的朋友可以去观摩观摩，也请帮忙点个 Star 支持一下，谢谢！ 小程序端（Uni-app + Vue3）： https://github.com/pudongping/momento-miniapp 前端部分 AI 占比 100%（自己一行代码都没写），接口部分 AI 占比 80% 我们要做的项目是一个记账小程序后端，核心功能包括：记账、多账本管理、多人协作、报表统计等。 技术栈： 看过我这个系列文章的同学应该都知道，当时我写这个小程序的时候，我是先写的小程序端，然后才写的 API 接口。这么做的好处就是： 当我把页面确定好了之后，所有的数据，我都让 AI 帮我填充了 mock 数据，并且是模拟的接口数据，这样当我觉得功能上没有什么大的问题的时候，我就直接让 ai 以 mock 数据为基础，帮我写好接口文档，并备注清楚特殊逻辑。 有了这份接口文档，我就可以让 ai 根据接口文档帮我设计数据库和开发真实的接口了。 我正在开发一个基于微信小程序的家庭记账应用“时光账记”。请根据我提供的接口文档帮我设计 MySQL 数据库 Schema。 核心需求： 技术要求： 当然了，你也可以更加详细的给 AI 提要求，比如： AI 会直接给你一套完整的 然后你就可以根据自己的实际情况，将 AI 帮你生成的 sql 文件修修改改调整成符合自己设想的。 下一步，就结合 sql 文件以及接口文档去定义 go-zero 框架的 go-zero 的核心优势是 Design First（设计优先）。我们需要先写 基于你刚刚设计的数据库 Schema 和我提供的接口文档，请帮我编写 go-zero 框架的 项目结构要求： 规范要求： 但是你会发现 AI 生成的 我的做法是，直接在 准备工作都已经做好了，那么如何让 AI 开始写符合自己代码风格的业务代码呢？ 我的方法是，自己先写好“模版”代码。 通过上面这个项目的实战，我们可以总结出用 AI 编程的三个核心秘诀： 在 AI 时代，编程的门槛确实已经降低了不少，但架构设计能力和将业务转化为技术需求的能力反而变得更重要了。掌握了这套方法论，你一个人就是一个开发团队！ 🚀 关注我，下期教大家如何用 AI 写接口的 CLAUDE.md，敬请期待～ 本文基于真实项目 Momento API 编写，项目已开源，欢迎 Star！时光账记
Uni-app + Vue 3 开发的个人记账微信小程序，后端接口基于 go-zero 微服务框架构建。
API 接口（Go + go-zero）： https://github.com/pudongping/momento-api
这也是一套非常不错的 AI 练手项目，如果对你有帮助，希望帮忙点个 Star 支持一下，谢谢！
项目背景与技术选型
💡 第一步：架构设计与数据库建模
🤖 提示词 (Prompt) 1：数据库设计
created_at, updated_at 字段，类型为 int(11) (存秒级时间戳)。-- =============================================
-- 「时光账记」数据库建表语句
-- 数据库版本: MySQL 5.7
-- 字符集: utf8mb4
-- 排序规则: utf8mb4_unicode_ci
-- 规范如下：
-- 1. 时间戳: 所有时间戳字段均为秒级时间戳（INT(11) UNSIGNED）
-- 2. 每张表都会有创建时间（created_at）和更新时间（updated_at）字段，类型均为 INT(11) UNSIGNED NOT NULL DEFAULT 0
-- 3. 每张表除了特殊说明，均会有自增主键 id 字段，并且类型为 BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT
-- 主键命名规范为 “表名单数_id” 比如用户表 表名为 users 主键则为 user_id
-- 4. 如果表中需要自定义排序字段时，统一使用 sort_num 字段，类型为 INT(11) UNSIGNED NOT NULL DEFAULT 0
-- 5. 如果表中需要自定义状态字段时，统一使用 status 字段，类型为 TINYINT(1) NOT NULL DEFAULT 0
-- 6. 如果表中需要用到枚举类型时，统一使用 smallint(1) NOT NULL DEFAULT 0 并且一般起始值不为 0，比如 1-未支付 2-已支付
-- 7. 如果表中需要用到金额类型时，统一使用 decimal(10,2) NOT NULL DEFAULT 0
-- 8. 如果表中需要用到时间、日期类型时，统一使用 int(11) unsigned NOT NULL DEFAULT 0
-- 9. 如果表中需要用到布尔类型时，统一使用 tinyint(1) NOT NULL DEFAULT 1 一般使用 1-是 2-否
-- 10. 软删除时，统一使用 deleted_at 字段，类型为 INT(11) UNSIGNED NOT NULL DEFAULT 0
-- 11. 表字段一般不用 not null，需要设置默认值
-- =============================================
-- =============================================
-- 索引优化说明
-- 1. 所有外键字段都建立了索引
-- 2. 常用查询条件字段建立了索引
-- 3. 时间字段建立了索引，便于按时间范围查询
-- 4. 组合索引遵循最左前缀原则
-- 5. 唯一索引用于保证数据唯一性
-- =============================================sql/momento.sql 文件，包含 users, account_books, account_book_members, transactions, tags 等表的建表语句，甚至连索引都帮你建好了。api 文件第二步：API 接口定义 (DSL) —— 让 AI 帮你“写契约”
.api 文件，然后自动生成代码。🤖 提示词 (Prompt) 2：API DSL 生成
.api DSL 文件。miniapp.api 直接放在项目根目录下的 dsl 目录下，模块文件需要根据模块进行划分，放在 dsl/ 模块目录下（如 dsl/user/user.api, dsl/transaction/transaction.api）。@doc 注解添加接口文档说明。page, per_page)。.api 文件也并不能百分百符合自己的要求，那么，此时就需要给 AI 更多的限定了。dsl 目录下创建了一个 API_STYLE_GUIDE.md 文件，在这个文件中写清楚了我的各种要求。感兴趣的童鞋可以把项目拉下来之后进行查看。
写业务代码
https://github.com/pudongping/momento-api/tree/master/coreKit 统一了相应数据格式、错误处理、参数验证等（但是，没有过度的封装）CLAUDE.md 文件，否则 AI 还是会“乱写”（下一篇文章就介绍写接口的 CLAUDE.md）总结