课程大纲
课程大纲系列主页
学习进度已完成 0/16

动手做第一版:和 AI 一起把它跑起来(含报错了怎么办)

进阶进行中

本章主记忆点:别想着一句话生成一整个产品——小步生成、立刻测、具体反馈,全程用 Git 兜底。

你看完能拿走什么

  • 选一个适合新手的 AI 编程工具,和把第一版跑起来的完整循环
  • 报错了怎么把错误丢给 AI、一轮轮逼到能跑,而不是自己干瞪眼
  • 一条保命习惯:用 Git 兜底,改坏了能一键退回上一个能跑的版本

前置条件

已完成上一篇 VDF——需求写清楚了。这一篇就动手:把那份需求,变成一个真能跑起来的第一版。 这是 vibe coding 最核心、也是 0 基础最容易卡住的一步。

第一步:选一个 AI 编程工具

写代码这件事,现在交给 AI 编程工具。新手别纠结,三个主流:

  • Cursor(首选):就是加强版的 VS Code,界面好上手,能一边对话一边改代码,改了哪几行看得清清楚楚,还能随意切 Claude / GPT 模型。新手直接从它开始。
  • Claude Code:在终端里跑,规划和多步执行能力强,适合习惯命令行的人。
  • Codex:OpenAI 生态,已经在用 ChatGPT 的人顺手。

装好工具,做的第一件事是开 Git。 不是为了规范——是为了改坏了能退回去(这一章后面会反复用到)。Cursor 这类工具自带版本回退,没有的话学一句 git commit 就够。

核心循环:小步生成 → 立刻测 → 具体反馈

新手最常见的错,是一句话让 AI 把整个产品生成出来,然后对着一坨跑不起来、也看不懂的代码发懵。

正确的节奏是一个循环,转起来:

  1. 先让 AI 规划,别急着写。 把你的 VDF 丢进去,让它先输出一份"要做什么 + 分几步做"的计划,你看一眼方向对不对。
  2. 小步生成。 让它一次只做一小块——"先把这个表单页做出来",而不是"把整个网站做出来"。
  3. 立刻测。 每生成一块,马上运行看效果(Cursor 内置终端 / 预览能直接跑)。别攒着,攒着就是一堆叠加的坑。
  4. 具体反馈。 哪里不对,说具体——"这个按钮太小、挪到右下角、换成蓝色",而不是"做得好看点"。AI 对模糊反馈("优化一下")几乎没用,对具体指令很灵。

转完一圈,再转下一圈。保持每一步都是能跑的,你就始终站在稳的地基上往前。

卡在第一关:怎么把它跑起来

很多 0 基础的人,第一道坎不是改 bug,是代码生成出来了,却不知道怎么让它跑起来

别慌,这一步也交给 AI。直接问它:"这个项目我现在怎么在本地跑起来?一步步说,命令直接给我能复制的。" 它会给你装依赖、启动的那几条命令(比如先 npm install,再 npm run dev),照着一条条敲,然后用浏览器打开它给的地址(通常是 http://localhost:3000),就能看到东西了。

要是敲了命令起不来——好消息,这就是你要调的第一个"错",按下面这节的方法,把报错整段丢给 AI 就行。能在 localhost 打开、看到东西的那一刻,你就跨过最难的一关了。

报错了怎么办:把错误丢给 AI,别自己瞎猜

第一版的过程里,报错是常态,不是你做错了。关键是怎么处理。

别自己对着红色报错瞎猜,也别只把"它报错了"告诉 AI。正确做法:

  • 完整的报错信息(整段,别只截一行)复制下来。
  • 连同出错的文件 / 那段代码、以及你期望它本来该干嘛,一起给 AI。
  • 让它先分析原因,再给最小的修复——别让它一上来大改。

Cursor 里更方便:直接选中报错的代码,用 Cmd+K 让 AI 当场改。实在定位不到,让 AI"先加几行日志(console.log)把中间值打出来",看清到底哪一步错了,再修。

调不出来:回退重来,别死磕

有时候一个 bug 改了三轮越改越乱——这时候别死磕,退回去。这就是为什么前面让你开 Git。

  • 每做完一个能跑的小功能,就存一个档git commit -m "完成登录页"
  • 改乱了,一键退回上一个能跑的版本git reset --hard HEAD~1(或用 Cursor 的 checkpoint 回退)。
  • 或者新开一个对话,带上你的需求重说一遍:"之前那条路走死了,忽略前面所有尝试,从干净状态用更好的方法重做这个功能。"——AI 在干净上下文里,往往比在一团乱里更清醒。

心态上记住:快速退回重来,比对着一个烂摊子死磕,省时间得多。

给 AI 立个规矩,少返工

每次都重复交代"用什么技术、什么风格"很烦。一劳永逸的办法:在项目根目录建一个规则文件(Cursor 是 .cursorrules),写上你的固定偏好:

text
- 用 React + Tailwind
- 组件用函数式写法
- 复杂逻辑加中文注释
- 不擅自引入新依赖,要加先问我

之后 AI 生成代码会自动守着这些,省掉一遍遍重复说,也少很多"风格各写各的"返工。

🤖 三个直接能用的 prompt

把上面的循环落成三个可复制的 prompt。

① 出第一版(先规划再动手):

text
这是我的需求(VDF):[贴上你的 VDF]。
先别写代码。先给我一份方案:要做哪些部分、分几步做、用什么技术栈,让我确认。
我点头后,从第 1 步开始,一次只做一小块,每做完一块告诉我怎么运行看效果。

② 具体反馈,逼近你要的样子

text
刚才那一版我跑了,问题是:[具体说哪里不对,比如"提交按钮太小、没居中、点了没反应"]。
只改这几个点,别动其它已经对的地方。改完告诉我重新运行看哪里。

③ 报错了,帮我调

text
报错了。完整报错信息:[整段粘贴]。
出错的文件 / 代码:[贴上]。我期望它本来应该:[描述]。
请先分析原因,再给最小的修复,别大改。定位不了就先加日志看中间值。

一个提醒:第 ③ 步,报错一定要贴完整那一整段,别只复制最后一行。错误的根因常常藏在中间,少贴了 AI 就只能猜。

存成你自己的 skill:把"出第一版"那条存成命令,每开一个新功能先跑它出方案。

AI 简历工具的第一版(贯穿案例)

把这套用到那个 AI 简历工具:

  • 选工具:用 Cursor,开 Git。
  • 规划:把 VDF 丢进去,让它先列"上传简历框 + 调 AI 出建议 + 展示结果"三块和步骤。
  • 小步做:先只做"贴简历 → 出 3 条建议"这一块,跑通;再加展示样式。
  • 报错:调 AI 接口报了个 key 的错——把整段报错 + 那段代码贴给 AI,它指出 key 没配进环境变量,给了修法。
  • 回退:试着加"历史记录"把界面搞乱了,git reset 退回上一个能跑的版本,重新小步来。

一个能跑的第一版,就这么一圈圈转出来了。

本章主记忆点

别想着一句话生成一整个产品——小步生成、立刻测、具体反馈,全程用 Git 兜底。

vibe coding 不是"许个愿等 AI 交付",是你带着 AI 一小步一小步往前蹚,每步都踩在能跑的地基上。

执行步骤

  1. 装一个 AI 编程工具(新手用 Cursor),打开项目、开 Git
  2. 把 VDF 丢进去,让 AI 先出"分几步做"的方案,你确认方向
  3. 让它一次只做一小块,每做完立刻运行看效果
  4. 不对就给具体反馈一轮轮改;报错就贴完整报错让它先分析再修
  5. 每做出一个能跑的小功能就 git commit;改乱了就回退重来,别死磕

验证方式

检查项过关标准
工具选定一个 AI 编程工具,项目开了 Git
节奏是小步生成 + 立刻测,不是一次让它生成一大坨
反馈给的是具体指令,不是"做好看点"这种模糊话
调试报错时贴完整信息 + 期望,让 AI 先分析再改
兜底有 commit 习惯,改坏了能退回上一个能跑的版本

五项都过 → 你已经能带着 AI 把一个想法变成能跑的第一版了,接下来用四大能力把它做好。

常见问题

Q:我完全不懂代码,AI 写的我看不懂,能行吗?

A:能起步。vibe coding 的重点是你会描述、会测、会反馈,不要求你读懂每一行。但有个底线:涉及钱、用户数据、对外发送的关键代码,后面"审查力"那章会教你怎么把关——那时候你得看懂"它在干嘛",不用看懂"每行怎么写"。

Q:AI 改着改着越改越乱,怎么办?

A:这恰恰是 Git 的用武之地。别在乱摊子上继续改——git reset 退回上一个能跑的版本,或新开对话带需求重做。记住:退回重来比死磕快。所以"每做完一小块就 commit"这个习惯,能救你很多次。

Q:Cursor、Claude Code、Codex 到底选哪个?

A:新手直接 Cursor,界面最像普通编辑器、上手最快。等你熟了,复杂规划可以配 Claude Code,看个人习惯。工具不是关键,那个"小步 + 测 + 反馈"的循环才是——换任何工具都成立。

Q:一次让 AI 全做完,不是更快吗?

A:看着快,实际慢。一次生成一大坨,跑不起来时你根本不知道哪错了,只能整段重来。小步生成虽然看着碎,但每步都能跑、能定位问题,整体反而快得多、稳得多——这和后面"系统思维"先画蓝图是一个道理。


数据来源:vibe coding 概念(Andrej Karpathy, 2025);AI 编程工具与协作流程(Cursor / Claude Code / Codex 官方文档、Addy Osmani 等公开工作流分享)。具体功能以各工具官网最新为准。

动手做第一版:和 AI 一起把它跑起来(含报错了怎么办) | 资讯狗 | Zixungou