跳到正文

提交

Commit

中级通用

提交(Commit)是 Git 在本地仓库中保存的一次项目快照,记录当时纳入提交的文件状态、说明和历史位置。它让你能追踪产品代码每一步改了什么;例如做完登录页后,单独留下一次可查的记录。

你可能会说:「登录页已经改好,帮我把这次改动留成一条以后能查到的记录。」

读之前建议先了解

动手看看

main当前所在 HEAD登录页骨架main · HEAD
1

登录页的布局做好后,先保存一次提交。这个圆点记录了当时纳入提交的文件状态,是后续改动的起点。

要点

  1. 1

    记录选中的文件状态

    提交保存的是这次纳入提交的文件状态,不是把你电脑上所有改动打包。比如你同时改了登录页和定价页,可以先只选登录页相关文件,提交一条聚焦的记录。

  2. 2

    用说明交代改动目的

    每次提交都带有一条说明。我们写“修复登录失败时没有提示”,以后查历史时就比“改了一些代码”更容易判断这次改动为什么存在。

  3. 3

    在本地接上项目历史

    提交会成为仓库历史中的一个节点,通常接在前一次提交之后。你和 AI Agent 做完一项改动就留一条记录,之后发现问题,才容易定位是从哪一步开始的。

容易混淆的地方

提交和保存文件不是一回事:保存只更新工作目录里的文件,提交才在 Git 历史中留下记录。提交和推送也不同:提交先发生在本地仓库;想让远程仓库收到这些记录,还要推送。未纳入提交的改动不会因为执行提交就自动进入历史。

什么时候用

适合用

  • AI Agent 完成登录页的错误提示,你检查过改动后,想单独留下这项功能的历史记录。
  • 后台筛选功能分两步实现,你想分别记录接口调整和页面调整,方便之后查找。
  • 修复线上反馈的一个显示问题,你想让团队以后能从历史中找到这次修复。

不适合用

  • 只是想看看 AI Agent 刚才改了哪些文件和内容,这时用差异对比,不用先提交。
  • 写到一半要临时切换任务,只想把未完成的改动暂时收起来,这时可用贮藏。
  • 想让已经提交的版本出现在网站上,提交本身不会发布网站,还需要部署上线。

练一练

你让 AI Agent 同时修改了登录页和定价页,现在只验收了登录页。你想留下可查的历史记录,接下来怎么做最合适?

让 AI 帮你做

请先查看当前 Git 改动,只把已完成并验收的登录页错误提示相关文件纳入一次提交,不要包含定价页改动。提交说明写清这次解决的问题;执行前列出准备纳入的文件和差异,等我确认后再提交。

接下来学什么