文档教程Vibe Coding示例工程【免费下载链接】vibe-vibeThe First Systematic Vibe Coding Open-Source Tutorial | From Zero to Full-Stack, Empowering Everyone to Build Products with AI | Live at: www.vibevibe.cn 首个系统化 Vibe Coding 开源教程 | 零基础到全栈实战让人人都能用 AI 开发产品 | 在线地址www.vibevibe.cn项目地址https://gitcode.com/datawhalechina/vibe-vibe点击查看免费下载导读本文对应 vibe-vibe 基础篇第 4 章的开篇小节 4.1 为什么先学存档以及 Git 的最小闭环讲解的是 Vibe Coding 项目中一个极易被忽略却至关重要的动作在改动真正变大之前先给项目装一个最小版本的时光机。读完本文你将掌握 Git 最小闭环的三个动作——存一次、看历史、退回来——并学会把整个闭环放心地委托给 AI 执行同时能说清这背后到底发生了什么。为什么要在改动变大之前先学会存档第 1 章和第 2 章时项目还很小改动也相对克制改坏了的代价很低。到了第 4 章情况开始变了你要加内容模块、调整页面结构、改变数字分身入口的使用方式很多修改都不再是一句文案那么轻。文档用三个非常具体的场景说明了这种牵一发而动全身加一个作品区顺手改到布局补联系方式不小心把首屏间距弄乱调整聊天入口结果别的地方一起变形。如果没有后悔药你很容易在改动时变得畏手畏脚或者因为一次改崩就把前面的努力一起拖下去。这里的顺序很重要不是项目彻底崩了才去学怎么回退而是在改动真正复杂起来之前先给自己留后路。这正是第 4 章把基础存档放在所有内容模块之前的原因——参考第 4 章导航4.1 的定位就是先建立安全感再继续大胆改动。基础版里 Git 只负责三件事如果你一听 Git 就紧张可以先把它想得更现实一点基础版的 Git 不是让你突然学会分支、PR、合并冲突而只是给项目装一个最基础的时光机。它只负责三件事动作你现在把它理解成什么存一次给当前稳定版本打一个可回来的点看历史看看自己之前存过哪些版本退回来某次改崩时回到上一个可用版本基础版附录 Git 最小操作卡 用一句话概括了同样的心智模型并给出了最重要的提醒不要等项目已经改崩了才第一次想起 Git。更稳的顺序是先存一次再大胆改。到这个程度就已经很够用。你不需要现在就知道很多命令参数也不需要理解完整协作工作流。你甚至可以把操作委托给 AI这一步完全可以沿用本书前面的思路不是所有操作都要自己硬背而是把目标说清楚让 AI 陪你走。4.1 给出了两个可以直接复制的说法。在动手改主页内容之前我现在准备开始给主页补内容。 在动手前请先帮我做一个最小存档让我之后改坏了还能退回来。 请一步一步带我完成不要展开 Git 理论。想确认目前还能退回哪里时请帮我查看这个项目目前有没有存档记录。 如果之后我改坏了告诉我最小回退路径是什么。 只讲这次需要知道的部分。附录 Git 最小操作卡 还把三个动作对应的委托话术都补齐了覆盖较大修改前存档改了几轮后查看可回退版本改崩后回到上一个稳定版本三种场景我现在准备开始做一轮较大的修改。 请先帮我给当前项目做一个最小存档作为可回退版本。 只告诉我这次需要知道的步骤不要展开 Git 理论。请帮我查看这个项目目前有哪些存档记录。 我想知道最近几个可回退版本分别是什么。这一轮修改效果不好。 请帮我回到上一个稳定版本并告诉我这次回退到了哪个存档点。这种说法很适合基础版你不是在上 Git 课而是在用 Git 解决一个马上会遇到的实际问题。用一句人话理解背后发生了什么4.1 刻意不展开 Git 理论但如果你想在会用之外再多懂一点进阶版 第十一章Git 版本控制与协作开发 提供了完整的人话解释可以帮你建立三层最小认知。先理解它解决了什么不再用文件名标记版本进阶版 11.1 为什么需要 Git 从最终版困境讲起写论文时桌面上会出现毕业论文-修改版.docx、毕业论文-打死不改版.docx这样的文件但哪个最新、改了什么、怎么回到三天前的版本文件名根本说不清楚。代码项目更严重——一个 Web 项目可能有几百个文件改一个功能往往涉及十几个文件的联动修改而且文件之间存在依赖关系A 文件调用 B 文件的函数必须把所有相关文件一起回到同一个时间点否则程序就跑不起来。Git 记录的不是某个文件的某个版本而是整个项目在某个时间点的完整快照一起保存、一起回滚。你可能已经在用 Git 了按 11.1 的描述如果你一直跟着本书用 Claude Code 开发项目你的项目目录里很可能已经有一个.git文件夹——Claude Code 创建新项目时通常会自动初始化 Git 仓库并在开发过程中帮你提交代码。验证方法很简单在项目目录里运行git log --oneline -5如果看到一串提交记录说明 AI 一直在帮你存档你只是在无意识地使用它。用git status也能确认仓库是否存在Windows 上.git是隐藏文件夹文件管理器看不到很正常。三个概念commit 存档、log 存档列表、status 一眼看状态commit提交 存档每次 commit 记录当前所有文件的状态附带一条描述和时间戳就像游戏里的手动存档。Git 的存档是增量式的只记录变化的部分所以你可以放心频繁提交不用怕占用空间。提交时机的判断标准很简单每当你完成了一件可以用一句话描述的事情就值得提交一次比如调整了首页布局修复了搜索为空的 bug不要攒一整天的修改一次性提交。git log 存档列表查看之前存过哪些版本。配合git diff、git show可以看清每次改动改了哪几行——养成改完看 diff的习惯能帮你确认 AI 到底改了什么。git status 一眼看电量像出门前看一眼手机电量它告诉你哪些文件改了但没暂存、哪些已暂存但没提交、当前在哪个分支。三区模型修改在哪里Git 管理代码有三个区域11.1 用三个比喻讲得很清楚区域比喻对应动作工作区书桌——文件摊开你正在改编辑文件暂存区整理好的一摞纸——这些是我要交的git add本地仓库档案柜——交上去的东西永久保存git commit日常开发中Claude Code 会帮你处理这些步骤但当我刚才的修改去哪了为什么提交里没有这个文件这类困惑出现时三区模型能帮你快速定位文件改了但git status显示未暂存说明还在工作区add了但没commit说明在暂存区还没存档commit了但没push说明存档只在本地。回滚无限层数的 CtrlZCtrlZ 有个隐含限制关掉文件再打开就失效了更别说回到三天前。Git 只要提交过就能回到那个时间点的状态——它是不用过期的、无限层数的 CtrlZ。三个常见场景对应三种处理方式场景处理方式后果改了半天方向错了还没提交丢弃工作区的修改无风险只是扔掉草稿已提交想回到上一个版本未推送远程git reset把本地仓库指针移回去那次提交从历史中消失要确认不再需要已推送到远程git revert创建反向提交不删除历史协作者 pull 也不会受影响对基础版来说你不需要背下这些命令——把场景说给 AI 听回到上一个能跑的版本撤销这几处修改AI 会选择合适的命令并把结果解释给你。核心认知是意识到你可以回去你就敢大胆尝试了。仓库里的真实证据什么该进存档、什么不该这个开源仓库本身就是用 Git 管理的——git log能看到仓库的提交历史。而仓库里的真实项目 demo-01-todo一个基于 Next.js 16 TypeScript Drizzle ORM PostgreSQL 的待办应用脚本定义见 package.json则展示了一个真实项目的存档边界见它的 .gitignorenode_modules .next .env drizzle .next-docs/这份配置告诉 Git 哪些东西不该进入存档node_modules第三方依赖随时可以由包管理器重新安装.nextNext.js 的构建产物属于可以重新生成的中间文件.env真实的密钥和连接串绝不能进版本库——项目只提交了 .env.example里面是DATABASE_URLpostgresql://user:passwordyour-neon-host.neon.tech/neondb?sslmoderequire这样的占位符drizzle数据库迁移的本地生成目录。也就是说存档记录的是该记录的东西你的源代码、配置模板、文档。依赖、构建产物、密钥这类不该入库的内容要用.gitignore提前挡在存档之外。更进一步代码只存在本地硬盘意味着单点故障——硬盘坏了、电脑被偷、系统重装代码就全没了。进阶版 11.2 推上云端开始协作 讲的就是把存档推到 GitHub/Gitee 等云端托管平台同时解决备份与多人协作问题。但那是进阶话题基础版只需要把本地闭环先跑通。有了存档心态会明显不一样一旦有了最小闭环后面的改动心态会完全不一样你会更敢补内容、更敢试不同写法、也更敢让 AI 帮你做稍大一点的调整。不是因为风险消失了而是因为你知道即使某次改坏了也不是世界末日——你有办法回到上一个稳定版本。第 4 章的后续小节把这个心态落到了操作节奏上。4.3 只添加 2-3 个最有价值的内容模块 明确建议每加一类模块前先做一次存档改完再看一次效果。这样你既不会因为改动变大而慌也能比较清楚地判断到底是哪一轮调整真正让页面变完整了。到 4.4 本章小结验收清单的第一项正是我已经知道怎么给项目做最小存档并在必要时退回来。最小操作速查卡场景对 AI 说的话示例底层对应的 Git 动作较大改动前存档请先帮我给当前项目做一个最小存档git addgit commit查看有哪些存档请帮我查看这个项目目前有哪些存档记录git log改崩了要回退请帮我回到上一个稳定版本并告诉我回退到了哪个存档点git reset/git revert确认当前状态我的修改现在在哪个阶段git status四个动作全部可以委托给 AI你只需要知道自己现在为什么需要它以及希望它替你完成什么。这一节在教程里的位置与下一步本节是基础篇第 4 章让主页更完整——内容、引导与基础存档的开篇作用是先建立安全感再进入 4.2 从访客视角决定你要补什么内容 和 4.3 补内容模块 的大改动阶段。第 4 章之后教程会进入 第 5 章让数字分身更像你。如果你想系统理解分支、PR、协作工作流可以继续读进阶版 第十一章Git 版本控制与协作开发——从 为什么需要 Git、推上云端开始协作 到分支、PR 与团队工作流。但在那之前请记住这一层最重要的事这一层安全感往往比我已经学会了多少 Git更重要。赞分享文档教程Vibe Coding示例工程【免费下载链接】vibe-vibeThe First Systematic Vibe Coding Open-Source Tutorial | From Zero to Full-Stack, Empowering Everyone to Build Products with AI | Live at: www.vibevibe.cn 首个系统化 Vibe Coding 开源教程 | 零基础到全栈实战让人人都能用 AI 开发产品 | 在线地址www.vibevibe.cn项目地址https://gitcode.com/datawhalechina/vibe-vibe点击查看免费下载相关推荐vibe-vibe 教程实战指南什么是 PRD为什么 Vibe Coding 必须先写它vibe vibe 教程实战指南什么是 PRD为什么 Vibe Coding 必须先写它 在 Vibe Coding氛围编程工作流中绝大多数AI 做文档教程Vibe Coding示例工程vibe-vibe Vibe Coding 实战上下文管理指南让 AI 记住你说过的话vibe vibe Vibe Coding 实战上下文管理指南让 AI 记住你说过的话 本篇技术指南围绕 Datawhale《vibe vibe》Vibe文档教程Vibe Coding示例工程Vibe Coding 中的 Context 管理实战三层上下文体系与项目级持久化vibe-vibe 教程精讲Vibe Coding 中的 Context 管理实战三层上下文体系与项目级持久化vibe vibe 教程精讲 Context上下文是 Vibe Co文档教程Vibe Coding示例工程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考