主线 · 第 2 / 8 篇
· 约 7 分钟
一次改动要经过哪几处:工作区、暂存区和 HEAD
改动从工作区出发,经过 git add 进入暂存区,再由 git commit 写进仓库。三处各存一份完整的项目内容,status 和三种 diff 比的都是其中两处。
刚开始用 Git,常遇到两件怪事。改完文件直接 git commit,Git 说 no changes added to commit,什么也没提交。或者先 git add 了一个文件,又接着改了几行,提交以后发现后改的那几行不在里面。两件事的原因相同:工作区和仓库之间,还隔着一层暂存区。
先说明几个词。工作区(working tree)是磁盘上能直接打开、编辑的那些文件。暂存区是下一次提交的草稿,Git 的正式术语叫索引(index),两个名字指的是同一样东西。HEAD 指向当前分支最新的那次提交,这里先把它理解成“上一次提交”,它到底是什么,留到讲分支的那一篇。
三个地方,各存一份
Pro Git 讲 reset 的那一章把这三处叫作三棵树:HEAD 是上一次提交的快照,索引是预期的下一次提交,工作目录是可以随便改的沙盒。这里的“树”泛指一整套文件,不是第一篇的树对象。
| 位置 | 存的是什么 | 怎么更新 |
|---|---|---|
| 工作区 | 磁盘上实际的文件 | 编辑器保存 |
| 暂存区 | 下一次提交要用的每个文件的内容 | git add |
| HEAD | 上一次提交的快照 | git commit |
容易误解的一点是,暂存区只放“这次要提交的改动”。实际上三处放的都是整个项目,不是改动。刚检出或刚提交完时,三份内容完全一样,git status 什么也不报。改一个文件,只有工作区变了;git add 之后,暂存区跟上;git commit 之后,HEAD 也跟上,三份又一致了。
暂存区是一份文件清单
暂存区本身是 .git 目录里一个叫 index 的文件。git-scm 的数据模型文档对它的描述是:一份文件清单,记着每个文件的内容,内容以数据对象的形式存放。和树对象不同,它是扁平的。
用第一篇的演示仓库来看。仓库里有 README.md 和 docs/a.txt,提交一次后,用 git ls-files --stage 列出暂存区,再和这次提交的树对照:
$ git ls-files --stage
100644 ce013625030ba8dba906f756967f9e9ca394464a 0 README.md
100644 78981922613b2afb6025042ff6bd878ac1994e85 0 docs/a.txt
$ git cat-file -p 'HEAD^{tree}'
100644 blob ce013625030ba8dba906f756967f9e9ca394464a README.md
040000 tree 08585692ce06452da6f82ae66b90d98b55536fca docs
两点不同。暂存区里 docs/a.txt 直接写完整路径,没有 docs 这一层子树,这就是“扁平”的意思。中间多了一列 0,是阶段号,平时都是 0,合并出现冲突时同一个文件会同时有几个阶段的版本,留到讲合并的那一篇。
清单里记的是哈希,说明 git add 的时候,文件内容已经存成了数据对象,不用等到提交。提交时,Git 把这份清单转成一棵树,再用这棵树生成提交对象。所以提交里有什么,只看暂存区里有什么,和提交那一刻工作区的样子无关。
add 记下的是那一刻的内容
把 README.md 改成两行,看 git status --short 的输出:
$ git status --short
M README.md
$ git add README.md
$ git status --short
M README.md
短格式的每一行前面有两列。没有合并冲突时,左列是暂存区相对 HEAD 的变化,右列是工作区相对暂存区的变化。 M 是右列有 M:工作区改了,暂存区还没跟上,这时提交就会得到开头那句 no changes added to commit。M 是左列有 M:改动进了暂存区,工作区和暂存区一致。
这时在提交前查暂存区里 README.md 那一条的哈希,是 94954ab,用 git cat-file -t 查,已经是一个 blob。
接着再给 README.md 加第三行,不再 add:
$ git status --short
MM README.md
两列都是 M。暂存区里还是两行的那一版,工作区已经是三行。git-add 的文档写得很直接:add 只加入执行那一刻的文件内容,之后的改动要想进下一次提交,必须再 add 一次。这时提交,进去的会是两行的版本,下一节先看清楚三处各是什么,再提交。
三种 diff 各比哪两处
git diff 有三种常见写法,各比两处:
| 写法 | 比较的两处 | 回答的问题 |
|---|---|---|
git diff | 工作区和暂存区 | 还有哪些改动没暂存 |
git diff --staged | 暂存区和 HEAD | 直接 git commit,会提交什么 |
git diff HEAD | 工作区和 HEAD | git commit -a,会提交什么 |
--staged 和 --cached 是同义词。在上面 MM 的状态下,三条命令的输出各不相同。只截取 index 那一行和增加的行:
$ git diff
index 94954ab..0056b4a 100644
+again
$ git diff --staged
index ce01362..94954ab 100644
+world
$ git diff HEAD
index ce01362..0056b4a 100644
+world
+again
index 那一行写的是比较双方的数据对象:ce01362 是 HEAD 里的一行版,94954ab 是暂存区里的两行版,0056b4a 是工作区里的三行版。三处三个版本,两两一比,就是三种 diff。这里的 index 只是 diff 头部的字段名,git diff HEAD 没经过暂存区,也照样有这一行。
最容易出错的是只看 git diff。它只显示还没暂存的改动,不是自上次提交以来的全部改动。全部 add 之后,git diff 什么也不显示,但下一次提交并不是空的。要看马上会提交什么,要用 --staged。
这时提交,进去的正是 --staged 显示的那些。提交后 git show HEAD:README.md 打出来的是 hello 和 world 两行,状态变回 M README.md,第三行还留在工作区。
提交前用 git write-tree 把暂存区单独转成树,得到 894c6d8,和提交后 HEAD^{tree} 一致,第一篇第二次提交的树也是这一棵。这次提交是 86c0fab,和第一篇第二次提交的哈希相同:内容、父提交、作者和时间都一样,算出来的名字自然一样。
git status 是这几组比较的摘要。按 git-status 文档的说法,它列出三类路径:暂存区和 HEAD 不同的,执行 git commit 就会提交;工作区和暂存区不同的,以及没有被跟踪的,要先 git add 才会进提交。
没被跟踪的文件不在这三层里
上面说的三份内容,只包括 Git 已经知道的文件。Pro Git 把工作区的文件分成两类:已跟踪的,是上一次快照里有、或者已经放进暂存区的;其余都是未跟踪的。新建的文件一开始都是未跟踪的,只存在于工作区。
在演示仓库里新建一个 todo.txt:
$ git status --short
M README.md
?? todo.txt
?? 表示未跟踪。常见的一个误解是 git commit -a 会提交所有改动。按 Pro Git 的说法,-a 是自动把所有已跟踪的文件暂存起来再提交,省掉 git add 这一步;未跟踪的文件不在其中。在演示仓库里执行一次 git commit -a,README.md 的第三行进了提交,todo.txt 仍然是 ??。
反过来,add 错了也能退回去。git add todo.txt 之后状态是 A todo.txt,执行 git restore --staged todo.txt,又变回 ?? todo.txt,文件还在工作区。按 git-restore 的文档,加了 --staged 时默认从 HEAD 取内容放回暂存区,不碰工作区。不加 --staged 则反过来,用暂存区的内容覆盖工作区,没暂存的改动会被丢掉,这一点留到讲撤回的那一篇。
构建产物、本地配置这类不打算跟踪的文件,可以写进 .gitignore,git add 默认不会加入被忽略的文件。
为什么要多这一层
直接把工作区存成提交,看起来更省事。多一层暂存区,好处是可以挑着提交:一次改了几处,可以只 add 其中一部分,先提交,再处理剩下的。git add -p 还能只暂存一个文件里的一部分改动。
oh-my-git(一个用闯关方式练 Git 的游戏)讲暂存区的那组关卡就从这里开始:同样的最终结果,一条历史把所有改动放在一个提交里,另一条拆成先后几步,后者更容易看出每一步做了什么。暂存区就是提交之前最后一处可以检查、可以调整的地方。
审 AI 的 Git 操作时,可以在提交前看两样东西。一是 git diff --staged,确认里面只有这次该提交的改动。二是 git status,看剩下哪些未暂存、未跟踪的文件,判断它们是该留着还是被漏掉了。另外留意它用的是指定路径的 git add,还是 git add .、git commit -a 这类一次带上一大片的写法。
参考资料
- Pro Git:Git 是什么?:已修改、已暂存、已提交三种状态,暂存区按术语叫索引。
- Pro Git:记录每次更新到仓库:已跟踪与未跟踪,
git diff只显示未暂存的改动,commit -a跳过暂存。 - Pro Git:重置揭密:HEAD、索引、工作目录三棵树。
- gitdatamodel:索引是扁平的文件清单,每条记录有类型、对象哈希、阶段号和路径。
- git-add:add 只加入执行那一刻的内容,默认不加入被忽略的文件。
- git-diff:三种写法分别比较的两处。
- git-status:status 列出的三类路径,短格式两列的含义。
- git-restore:
--staged默认从 HEAD 恢复,否则从暂存区恢复。 - oh-my-git:讲暂存区的一组关卡,从“一个提交”和“分步提交”的对比开始。
本文涉及的知识点
9 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。
本节知识点
本节知识点
本节知识点
本节知识点