Skip to content

第一次保存项目版本

这一课让学员完成第一次 Git 保存。

前一课讲概念,这一课做动作:查看状态、查看改动、提交一次版本,并写清楚这次完成了什么。这一课要给学员一个非常明确的身体记忆:保存版本就是“看一眼、选一下、写一句、确认一下”。

  • 让学员会查看项目状态。
  • 让学员会查看本次改动。
  • 让学员会提交一次版本。
  • 让学员会写清楚提交信息。
  • 让学员会确认保存成功。
  • 建议时长:25 到 35 分钟。
  • 用课程 demo 项目演示。
  • 每个命令都先让 AI 解释作用。
  • 提交信息用人话写。
  • 保存前一定展示“先看改动”。

可以这样开场:

“今天我们给项目钉下第一枚时间钉。以后再打开这个项目,你会知道:这里曾经完成过第一版网页。”

第一次保存版本,可以拆成四步。

第一步,查看状态。

查看状态,就是问 Git:项目现在有哪些变化。

第二步,查看改动。

查看改动,就是问 Git:这些变化具体是什么。保存前先看改动,可以避免把不想保存的内容也放进去。

第三步,提交版本。

提交,就是把当前稳定成果保存成一条历史记录。

第四步,写提交信息。

提交信息不要写成“update”这种含糊词。可以写:

完成个人主页第一版

或者:

增加联系方式区域

提交信息写给未来的自己看。半年后再回来,你要能一眼看懂这一刻做了什么。

录制时要提醒一个重要边界:保存前先看改动。很多新手看到保存按钮或命令就急着点,结果把不想保存的内容也放进去了。第一次保存时,宁可慢一点,也要让学员形成“先看再存”的习惯。

可以把第一次保存拆成四个问题:

第一,我改了哪些文件?

第二,这些改动是不是我想保存的?

第三,我准备用一句什么话描述这次改动?

第四,保存后历史里是否多了一条记录?

协作文本:

请帮我检查这次是否适合保存版本。
当前改动:
我这次完成的事情:
我准备写的提交信息:
请告诉我:
1. 提交信息是否清楚
2. 有没有看起来不该一起保存的改动
3. 保存前还需要检查什么

最后收束:

“第一次保存不用追求快。先看改动,再写清楚,再确认历史里多了一条记录。这个习惯会保护你后面所有项目。”

  1. 打开 demo-site 项目。
  2. 修改一个小文件。
  3. 让 AI 解释即将运行的 Git 命令。
  4. 查看当前状态。
  5. 查看本次改动。
  6. 选择要保存的改动。
  7. 写清楚提交信息。
  8. 完成提交。
  9. 再查看状态,确认工作区干净。
  10. 查看历史里新增记录。
  11. 把提交信息交给 AI,让它判断是否清楚。
  • 我修改了什么:
  • 我查看到哪些改动:
  • 我决定保存哪些改动:
  • 我的提交信息:
  • AI 对提交信息的建议:
  • 历史记录是否出现:
  • 保存后状态:

让学员完成第一次提交:

  • 查看状态。
  • 让 AI 解释状态。
  • 查看本次改动。
  • 提交版本。
  • 写一句清楚提交信息。
  • 确认历史记录里出现新提交。
  • 项目还没初始化仓库:让 AI 帮忙检查并说明下一步。
  • 有很多无关文件:先让 AI 判断哪些应进入版本记录。
  • 提交信息太泛:写动作和结果。
  • 提交后仍有变化:再次查看状态,确认剩余内容。
  • 不敢提交:提醒这是保存稳定小成果,不是发布上线。

保存第一次提交记录截图,并写下:

  • 本次提交信息。
  • 这次保存了什么成果。
  • 下一次准备保存什么。
  • AI 是否认为提交信息清楚。
  • 第 1 页:标题“给项目钉下第一枚时间钉”
  • 第 2 页:查看状态
  • 第 3 页:查看改动
  • 第 4 页:提交版本
  • 第 5 页:写提交信息
  • 第 6 页:确认状态和历史