你可能会说:
- “AI 一次改了几十个文件,出问题了怎么知道是哪一处?”
- “提交说明随便写写可以吗?”
它是什么
每个提交都有一个唯一编号,记录了这次改动的所有文件差异、作者、时间和说明。回看历史、找出问题、撤销改动,都是以提交为单位。
好的提交是"原子的":一个提交只做一件事,比如"修复移动端溢出",而不是把修 bug、改样式、加功能混在一起。这样出了问题可以只撤销那一个,不影响别的。
提交说明要写"为什么",代码本身已经说明了"改了什么"。三个月后你(或 AI)回头看,最想知道的往往是当时为什么这么改。
打个比方
像记账本上的一笔账:金额、日期、用途都写清楚。一个月后对账,靠的就是每一笔都记得明白。
在这个网站里
这个网站的提交都是小而独立的:比如"/e2e/mainline 改由 Cloudflare Pages 返回真正的 301"单独一个提交,只动了 4 个文件,说明里写清了原因。每批提交推送前,还会逐个检查每个提交都能单独构建成功。
容易搞混的地方
常见误解
做完一整个功能再一起提交,历史更清爽
正确理解
一个大提交出了问题,只能整个撤销。拆成小提交,才能精确地找到、撤回出问题的那一步。
你可以这样告诉 AI
复制下面这段,贴给你的 AI
把这次的改动按独立的目的拆成几个提交,每个提交只做一件事、能单独构建通过;提交说明第一行写改了什么,正文写为什么。提交之前先让我看一下拆分方案。
接下来去哪
先知道
- Git——给整个项目拍快照的工具:每次存档都记下改了什么、谁改的、为什么改,随时能回到任何一次。
接着看
- 分支——从某个存档岔出去的一条独立开发线:在上面随便改,不影响主线,满意了再合并回去。
在这些课里出现