Vibe Coding 实战指南：我用 AI 辅助写完了一整个项目
Vibe Coding 实战指南：我用 AI 辅助写完了一整个项目
从一张白纸到能跑起来的项目，全程 AI 帮忙，我把踩过的坑和总结的经验都记下来了
一、啥是 Vibe Coding？我刚开始也一头雾水
第一次听说 “Vibe Coding” 这个词是在技术群里，有人在讨论"现在写代码都不用自己动手了"。我当时心想，这不扯淡吗？后来自己试着用这种方式做了一个课程项目，才发现确实不一样。
简单说，Vibe Coding 就是你描述需求、AI 写代码，你负责"把关"而不是"搬砖"。想象一下你是一个项目的"产品经理"，AI 是你的"主力开发"，你把活派给它，它把代码写出来，你来 review、调整、整合。
不过我得先说清楚：这不代表你不需要会写代码。你不需要手写每一行，但你得能看懂、能判断好坏、能指方向。就像你不会开车也能当导航员，但你得会看地图、知道目的地是哪儿。我目前大三，前后端都写过一些，但离"熟练"还差得远。用 Vibe Coding 的方式做项目，让我能把精力放在"这个功能怎么做才对"上，而不是"这个语法怎么写"上。
二、整体流程：我是这么一步步走过来的
我把自己做项目的流程整理了一下，大概是这么个节奏：
第一步：确定要做啥（PRD）—— 写清楚这个项目是干什么的、给谁用、核心功能是什么
第二步：搭个样子出来（原型设计）—— 页面长什么样、用户怎么操作，有个大概的草图就行
第三步：数据怎么存（数据库设计）—— 需要哪些表、表之间怎么关联、字段怎么定义
第四步：前后端怎么分工—— 技术选型、API 怎么设计、项目结构怎么组织
第五步：API 文档先行—— 先写 API 文档，后端和前端都按文档来
第六步：后端代码生成—— 让 AI 生成后端框架代码，自己过一遍逻辑
第七步：前端代码生成—— 让 AI 生成前端页面，对接 API
第八步：测试和联调—— 后端接口测试、前后端联调
第九步：收尾—— 部署、写文档、整理提交记录
下面我把每一步怎么用 AI 辅助、需要注意什么，详细展开说一下。
三、第一步：PRD——先想清楚再做
PRD（产品需求文档）是所有工作的起点。我的习惯是：先跟 AI 聊，把我的想法说出来，让它帮我整理成规范的文档。
我是这么做的：
告诉 AI 你的项目背景、想做啥、核心功能有哪些、做成啥样算成功。一般 AI 会帮你生成一个结构清晰的 PRD，包括项目背景、用户画像、功能清单、优先级划分、验收标准这些。
经验提醒：
PRD 里一定要写清楚"不做啥"。AI 很擅长帮你发散，但项目边界不划清楚，后面会越做越偏。我见过一个同学做项目管理工具，做着做着变成了带聊天功能的协作平台——功能是好功能，但它不在最初的设计里，加进去之后整个数据库都要改。
我的小习惯：
每完成一个阶段，让 AI 更新一下项目根目录的说明文档，把最新的进度、技术决策、踩过的坑都记下来。这样下次打开项目，不用从头回忆。
四、第二步：原型设计——先看见再动手
PRD 定下来之后，别急着写代码。先想清楚页面长啥样、用户怎么操作。
我是这么做的：
把 PRD 交给 AI，让它帮我梳理页面结构和用户操作路径。我不追求像素级精确的原型图，但页面布局、信息层级、用户从 A 到 B 要经过哪些步骤，这些要搞清楚。
经验提醒：
多花时间想清楚"用户怎么走到目的地"。比如购物车功能，从"加入购物车"到"支付成功"要经过几个页面、点击哪些按钮、每一步看到什么信息。大多数项目后期改来改去，都是因为这一步没想透彻。
五、第三步：数据库设计——地基得打牢
原型有了、功能清晰了，现在要设计数据怎么存。这一步很关键——数据库结构一旦上线，改起来特别麻烦。
我是这么做的：
把 PRD 和原型描述交给 AI，让它帮我分析需要哪些表、表之间什么关系、每个表有哪些字段。然后让 AI 直接生成 SQL 建表语句。我会仔细过一遍，有不合理的地方让 AI 改，直到确认没问题。
经验提醒：
字段类型选准：金额用 decimal 别用 float（浮点数精度问题会坑人），状态用 tinyint 别用 varchar，时间用 datetime 别用 timestamp（时区问题）
预留扩展字段：业务刚起步的时候可能只需要 name 和 price，但半年后可能就要 category、tags、sort_order…… 我吃过这个亏，一开始表设计得太死，后面加字段的时候发现已经有数据了，迁移起来特别痛苦
软删除是标配：加一个
is_deleted字段，别真删数据。有天你发现用户数据被误删了，而你的表里干干净净什么都没有，那一刻你就明白软删除多重要了
六、第四步：技术选型和架构设计
数据库设计好之后，前后端怎么分工、用什么技术、怎么组织代码，要有明确的方案。
我是这么做的：
让 AI 根据项目规模推荐技术栈。比如我会说"这是一个中小型 Web 项目，我一个人做"，AI 可能会推荐后端用 Python + FastAPI 或 Node.js + Express，前端用 Vue3 或 React，数据库用 MySQL。然后我会选自己相对熟悉的。
选技术栈的原则：用你熟悉的。AI 再厉害，遇到编译错误还是得你来修。用之前用过、踩过坑的技术，比追求"最新最潮"稳妥得多。
前后端约定要提前定好：
- API 返回格式统一：
{code: 0, data: {...}, msg: "success"} - 状态码怎么用
- 鉴权方式：JWT 还是 Session
- 分页参数命名：
page和pageSize还是offset和limit
这些约定如果等到联调阶段才讨论，前端等后端、后端等前端，时间就浪费了。
七、第五步：API 文档先行
前后端约定好之后，先定义 API 文档，再开始写代码。
我是这么做的：
让 AI 根据数据库设计和 PRD，生成完整的 API 文档。包含每个接口的路径、方法、请求参数、返回示例、错误码说明。生成之后，前端和后端都基于这个文档各自开工。
为什么 API 文档要先写？
- 前后端可以并行开发，不用互相等
- 接口契约明确，减少联调时的 surprise
- AI 生成代码时可以引用文档，准确率更高
八、第六步：后端框架代码生成
API 文档有了、PRD 有了、数据库也有了，现在可以让 AI 生成后端的框架代码了。
我是这么做的：
把 API 文档和 PRD 交给 AI，让它生成项目骨架、路由定义、控制器基本结构、服务层和 DAO 层的模板代码。生成的代码我会过一遍，理解每段代码是干什么的。如果看不懂，就让 AI 解释：“这段代码是干什么的？为什么要这么写？”
经验提醒：
让 AI 生成的代码，一定要自己能读懂。你不需要成为专家，但必须能判断它生成的代码是否合理。
九、第七步：前端开发
后端框架有了，API 也有了，现在轮到前端。
我是这么做的：
把 PRD、原型设计、API 文档一起交给 AI，让它生成前端页面代码。包括路由配置、页面组件、API 调用封装、状态管理等。
经验提醒：
前端代码的修改频率通常比后端高，所以可读性比"极致性能"更重要。别让 AI 写那种特别花哨但回头自己都看不懂的代码。另外，如果后端接口还没完全写好，可以先让 AI 生成 mock 数据，前端先跑起来。
十、第八步：测试和联调
后端测试：
让 AI 生成测试代码。先把每个接口单独测试跑通——用不同参数调接口，看返回对不对、数据库数据对不对、异常情况能不能正确处理。这一步做好了，联调会顺利很多。
前后端联调：
后端接口测试通过后，前端页面连上后端真实接口，从登录到操作到退出，把完整流程跑一遍。发现问题别慌，把错误日志贴给 AI，它能帮你定位问题。
经验提醒：
联调阶段遇到的问题，绝大多数是"约定不一致"导致的——字段名拼写不对、数据类型不匹配、状态码理解不同。所以前期 API 文档越细，联调越顺。
十一、几个让我印象深刻的教训
教训一：别让 AI 同时做太多事
我试过把整个项目需求一次性扔给 AI，让它生成所有代码。结果生成的代码到处是 bug，互相之间还有冲突。后来学乖了，一个模块一个模块来——“先帮我写用户登录注册”，跑通了再加下一个。
教训二：设计文档比代码更重要
我一开始觉得"花时间写文档浪费时间"，直接让 AI 开始写代码。结果做到一半发现数据库设计有问题，前端页面推倒重来，白白浪费了两天。后来养成习惯：先让 AI 生成设计文档，花半小时过一遍，确认没问题再开工。这半小时能省后面好几天的返工。
教训三：一定要跑端到端测试
每个模块单独跑都没问题，但串起来就报错。这种情况在 AI 辅助开发里特别常见。所以在交付之前，至少跑一遍完整流程：登录 → 操作功能 A → 操作功能 B → 退出，确保整条链路是通的。
教训四：环境变量统一管理
AI 生成的代码里经常直接写死数据库连接字符串、API Key 这些东西。上生产之前一定要全部迁移到环境变量里，别偷懒。
十二、总结
Vibe Coding 不是让 AI 替你把所有活干了，而是你负责思考，AI 负责执行。你仍然是那个决定"做什么、做成什么样"的人，AI 是你那个干活贼快、偶尔也会犯糊涂的助手。
作为一个大三学生，我的感受是：这种开发方式最大的价值不是"省时间"，而是帮你快速试错。以前做一个新功能，心里没底的时候想到要写几百行代码就不想动了。现在有了 AI，半小时就能把原型跑起来，行不行一下就知道了。不行就扔掉重来，试错成本极低。
如果你也在尝试用 AI 辅助做项目，希望这篇分享对你有帮助。欢迎交流你遇到的坑和心得。