为什么需要版本记录？

07-01 为什么需要版本记录？

课程定位

这一课进入 Git 和版本记录。

学员已经学会让 AI 修改项目。下一步要建立安全感：项目改坏了怎么办？忘记改过什么怎么办？想回到上一版怎么办？版本记录的价值，就是给项目留下时间锚点。

这一课先讲为什么需要版本记录，不急着讲复杂命令。

本课目标

• 让学员理解版本记录解决什么问题。
• 让学员知道 Git 可以保存项目历史。
• 让学员知道版本记录会降低试错恐惧。
• 让学员理解什么情况算稳定成果。
• 让学员完成一张版本意识卡。

录制建议

• 建议时长：22 到 30 分钟。
• 先展示“最终版、最终版2、最终最终版”的混乱。
• 再展示 Git 提交历史。
• 不急着讲命令，先讲为什么需要。
• 用“阶段照片”和“试错护栏”两个比喻。

讲稿正文

可以这样开场：

“很多人做文件，最后都会变成这样：最终版、最终版2、最终最终版、最终真的最终版。项目一旦开始改，靠文件名记历史会越来越乱。”

Git 像数字世界的时光机。每次你觉得项目到了一个稳定状态，就拍一张照片。以后你可以看到这一刻改了什么，也可以知道自己从哪里走到哪里。

版本记录解决三个恐惧。

第一，改坏了回不去。

如果 AI 修改后页面坏了，有版本记录时，你知道上一个稳定点在哪里。

第二，忘记自己改过什么。

项目做久了以后，人很难靠记忆记住每一次变化。版本记录会把变化写进历史。

第三，AI 改动范围太大。

有了版本记录，你可以先保存稳定成果，再让 AI 修改。这样试错会更有底。

很多人害怕试错，是因为试错没有退路。有了版本记录，试错就不再像跳悬崖，更像在有护栏的楼梯上往前走。

这里要把“稳定成果”讲具体。稳定成果指一个能描述清楚的小节点。

比如：

• 项目文件夹建好了。
• 第一版页面能打开了。
• 标题和按钮文案改好了。
• 报错已经修好。
• README 草稿写好了。

每到这种节点，就值得保存一次版本。这样以后 AI 再改项目时，你心里有底：如果新改动不满意，至少知道上一个稳定点在哪里。

提交信息可以用人话写：

完成第一版页面
修复按钮点击没有反应的问题
补充 README 使用说明
调整首页标题和配色

本节先不要求学员掌握所有 Git 命令，只要理解三件事：

• 项目有历史。
• 每次稳定成果可以保存。
• 保存时写一句这次做了什么。

最后收束：

“版本记录不是程序员仪式感，它是普通人和 AI 一起改项目时的安全带。”

屏幕演示流程

1. 展示一组混乱文件名。
2. 打开一个已有 Git 历史的项目。
3. 展示几条提交记录。
4. 点开一条记录，说明它保存了什么。
5. 展示一条好提交信息和一条差提交信息。
6. 让 AI 用大白话解释 Git 的价值。
7. 让 AI 判断提交信息是否能让未来的自己看懂。

版本意识卡

• 我最怕改坏的地方：
• 我希望保存的关键节点：
• 什么情况算稳定成果：
• 我准备使用的提交信息写法：
• 我下次修改前要先检查什么：

课堂练习

让学员写下自己最担心的三件事：

• 怕改坏什么。
• 怕忘记什么。
• 怕 AI 乱改什么。
• 版本记录可以怎样缓解这个担心。

再写 3 条适合自己项目的提交信息。

常见卡点

• 学员觉得 Git 很专业：先把它理解成项目历史。
• 学员害怕命令：这一课先不做命令训练。
• 学员不知道什么时候保存：每个稳定小成果保存一次。
• 学员提交信息乱写：用一句人话说明本次完成内容。
• 学员想每一步都保存：到稳定节点再保存，避免历史太碎。

课后作业

完成版本意识卡：

• 我最怕项目哪里改坏。
• 我希望保存哪些关键节点。
• 我以后提交信息准备怎么写。
• 写 3 条适合自己项目的提交信息。

课件页建议

• 第 1 页：标题“Git 是数字世界的时光机”
• 第 2 页：最终版混乱
• 第 3 页：项目历史
• 第 4 页：试错护栏
• 第 5 页：稳定成果就保存
• 第 6 页：版本意识卡