Git 教学工作区 · 课程 0003 · 约 20 分钟 · 前置:0001 对象模型 · 2026-10-16

暂存区不是"临时区":三棵树与三次快照

这节课的胜利:让同一个文件的三个版本同时显形 —— 版本库里一份、暂存区一份、 工作区一份,再用 git diff 的三种比较逐层指出差异落在哪一层;最后完成一次 add 之后反悔(git restore --staged)。做完这一节,回滚类命令就不再靠背。

先自己回忆(别翻上面)

合上资料,用一句话说出下面三件事:① 三棵树分别叫什么;② git add 到底改了哪一棵树;③ git commit 把哪棵树写成了什么。

想不起来就回到 0001 里 git cat-file -p 那一段,再看一眼 commit 里指向的 tree。

为解决什么痛点而生

痛点:如果只有"工作区"和"版本库"两层,commit 就只能一次提交全部改动。 想"这次只提交修 bug 的部分,顺手做的重构下次再说",就没有地方停一下 —— 于是人们开始把改动先手工拆开、 来回拷贝文件,或者干脆放弃拆分。

定义:Git 在中间加了一层 暂存区(index / stage)。 git add 把工作区当前内容写成一份快照放进暂存区;git commit 把暂存区这一份写成 一个 commit 对象(连同它的 tree),版本库指针 HEAD 随之前移。

大白话:暂存区是一张"这次要交的清单"。工作区是你桌上的草稿,版本库是档案柜; add = 把草稿放进清单,commit = 按清单归档。清单里放什么,由你逐次决定 —— 这就是"分批提交"的实现方式。

三棵树,三组命令

树是什么看它改它
工作区磁盘上你正在编辑的文件git diff(工作区 vs 暂存区)你用的编辑器
暂存区下一次 commit 的内容(二进制索引 .git/index)git diff --staged(暂存区 vs HEAD)、git ls-files -sgit add / git restore --staged
版本库已提交的 commit 与 tree/blob 对象git log、git cat-file -p HEADgit commit / git reset / git revert
工作区->git add->暂存区->git commit->版本库(HEAD)

现场实测:让三棵树同时显形

下面是我在临时仓库里真跑出来的输出(git version 2.5x)。一路照抄即可复现。

$ git status --short
?? a.txt                      # 未跟踪:工作区有,另外两棵树都没有

$ git add a.txt
$ git status --short
A  a.txt                      # 已进暂存区待提交(左列 = 暂存区状态)

把工作区再改一点,然后三种 diff 各看一次 —— 差异分别落在哪一层,一眼可辨:

$ printf 'B\n' >> a.txt

$ git diff                    # 工作区 vs 暂存区:只有新增的 B
@@ -1 +1,2 @@
 A
+B

$ git diff --staged           # 暂存区 vs HEAD:只有 A(因为 B 还没 add)
@@ -0,0 +1 @@
+A

$ git diff HEAD               # 工作区 vs HEAD:两层加起来(首次提交前 HEAD 为空)

提交之后,继续"改一点、add 一点、再改一点",就能看到三层各自的样子:

$ printf 'C\n' >> a.txt && git add a.txt && printf 'D\n' >> a.txt

$ git diff               # 工作区 vs 暂存区:只有 D
@@ -1,3 +1,4 @@
 A
 B
 C
+D

$ git diff --staged      # 暂存区 vs HEAD:只有 B、C
@@ -1 +1,3 @@
 A
+B
+C

$ git ls-files -s        # 暂存区的真实形态:一行 = 一个 blob 哈希 + 路径
100644 b1e67221afe8461efd244b487afca22d46b95eb8 0       a.txt

在 Windows 上你会额外看到 warning: in the working copy of 'a.txt', LF will be replaced by CRLF… —— 那是行尾转换提示,不是报错,与三棵树无关。

add 之后反悔

$ echo bad > a.txt && git add a.txt     # 误把改动放进了清单
$ git status --short
M  a.txt                                  # 暂存区已改
$ git restore --staged a.txt              # 只把"清单"退回,不碰工作区内容
$ git status --short
 M a.txt                                  # 改动还在工作区,只是不再待提交

练一遍(验收点清楚可见)

在任意一个临时目录里(不要用本库)做一遍:建仓库,建两个文件,只把其中一个 add 进暂存区, 然后依次跑 git status --short、git diff、git diff --staged,并回答:哪一个文件出现在哪条命令里?

验收点:你能不看本页说出"git diff 只显示没 add 的,--staged 只显示已 add 的"。

把上面那份 M a.txt 的改动先 git add,再 git restore --staged, 观察 git status --short 首列从 M 变回空 —— 讲清"版本库里那份快照从头到尾没被动过"。

自测(等长选项,可反复试)

你改了 a.txt 并 git add 之后,又改了它一次。此时 git diff 会显示什么?

为什么:git diff 比较的是工作区 vs 暂存区。第一次改动已经进了暂存区,所以只剩第二次还没进清单的那部分。

哪条命令能看清"下一次 commit 到底会提交什么"?

为什么:--staged(等价 --cached)比的是暂存区 vs HEAD,正是"清单里有什么"。提交前扫一眼它,能挡住九成的误提交。

一手来源

任何一步卡住,直接回来问 —— 说清你跑的命令与原文输出,我给你下一步;要"只提问不给答案"的带练就说一声。