← 术语图鉴

提交

Commit · 也叫 commit / 存档 / 提交记录

Git 里的一次存档:一组改动,加一句说明它改了什么、为什么改。

你可能会说:

  • “AI 一次改了几十个文件,出问题了怎么知道是哪一处?”
  • “提交说明随便写写可以吗?”

它是什么

每个提交都有一个唯一编号,记录了这次改动的所有文件差异、作者、时间和说明。回看历史、找出问题、撤销改动,都是以提交为单位。

好的提交是"原子的":一个提交只做一件事,比如"修复移动端溢出",而不是把修 bug、改样式、加功能混在一起。这样出了问题可以只撤销那一个,不影响别的。

提交说明要写"为什么",代码本身已经说明了"改了什么"。三个月后你(或 AI)回头看,最想知道的往往是当时为什么这么改。

打个比方

像记账本上的一笔账:金额、日期、用途都写清楚。一个月后对账,靠的就是每一笔都记得明白。

在这个网站里

这个网站的提交都是小而独立的:比如"/e2e/mainline 改由 Cloudflare Pages 返回真正的 301"单独一个提交,只动了 4 个文件,说明里写清了原因。每批提交推送前,还会逐个检查每个提交都能单独构建成功。

容易搞混的地方

常见误解

做完一整个功能再一起提交,历史更清爽

正确理解

一个大提交出了问题,只能整个撤销。拆成小提交,才能精确地找到、撤回出问题的那一步。

你可以这样告诉 AI

复制下面这段,贴给你的 AI

把这次的改动按独立的目的拆成几个提交,每个提交只做一件事、能单独构建通过;提交说明第一行写改了什么,正文写为什么。提交之前先让我看一下拆分方案。

先知道

  • Git——给整个项目拍快照的工具:每次存档都记下改了什么、谁改的、为什么改,随时能回到任何一次。

接着看

  • 分支——从某个存档岔出去的一条独立开发线:在上面随便改,不影响主线,满意了再合并回去。

在这些课里出现