历史查看、撤销与忽略

上一课走完一条直路:改文件、git add、git commit,三次提交排成一条线。 真实开发里更常见的是后发现不对 —— 改动写完才想起来这一版不能用,提交上去才发现漏了文件。 本节课内容就是如何查询历史提交以及如何撤回提交

这一课从「看清之前提交了什么内容」开始,再按怎么退分成三种退法。 先把现在这个仓库调出来,后面每一节都以它为准:

git log --oneline #这个参数只看每次提交的信息的第一行,不加即可展示详细提交内容
6a5d89f bump version to 3 and add retry limit
f6495ed bump version to 2 and add util.sh
64a7c45 add app and readme

三条,最新的一条在上面。记住 6a5d89f —— 后面「退回去」和「找回来」都要用到它。

哈希(6a5d89f)是「提交对象」的唯一标识/内容地址

"bump version to 3 and add retry limit",这一段是用户提交的说明信息

先看清现在站在哪

git log 的参数很多,日常要回答的只有四个问题:顺序是什么、在哪条线上、这一次改了什么、 这一行是哪一次加进来的。一个问题一条命令。

三条提交排成一条线

加两个选项,把线的形状和指针的位置一起打出来:

git log --oneline --graph --decorate --all
* 6a5d89f (HEAD -> main) bump version to 3 and add retry limit
* f6495ed bump version to 2 and add util.sh
* 64a7c45 add app and readme

--all 把本地分支、远程分支、标签一起算进历史,不加它只看当前分支。

--decorate 在提交旁边标出哪些引用指向它:分支名、标签、HEAD、远程跟踪分支。

--graph 用 ASCII 字符把提交历史画成图,能直观看到分支从哪分出去、在哪合并回来。

和上一条比,每行前面多了 *,第一行后面多了 (HEAD -> main)。

* 是一个提交点,| 是父子之间的连线 —— 这里一个竖线都没有, 因为三条提交是直线,还没有分叉。(HEAD -> main) 读作「HEAD 指向 main, main 指向这条提交」。

这一次到底改了哪几行

把 --oneline 换成 --stat,每条提交下面会挂一张改动表:

git log --stat -1
commit 6a5d89f50740ce5c8653e169e4da5a5c7ddb9988 #完整哈希值
Author: Zhang San <zhangsan@example.com> #提交的用户名
Date: Fri May 1 10:00:00 2026 +0800 #日期 bump version to 3 and add retry limit #提交的说明信息 app.txt | 2 +- util.sh | 1 + 2 files changed, 2 insertions(+), 1 deletion(-)

app.txt | 2 +- 是「动了两行,一加一减」,util.sh | 1 + 是「只加了一行」,最后一行合计。 -1 只取最近一条;去掉它,每条提交都挂一张表。

要看到具体是哪几行,把 --stat 换成 -p。提交信息那几行和上面一样,这里从 diff 开始:

git log -p -1
diff --git a/app.txt b/app.txt
index badc32f..9e7c0da 100644
--- a/app.txt
+++ b/app.txt
@@ -1 +1 @@
-version=2
+version=3
diff --git a/util.sh b/util.sh
index 5fbd037..7b82278 100644
--- a/util.sh
+++ b/util.sh
@@ -1 +1,2 @@ export PATH=$PATH:/opt/tools
+MAX_RETRY=3

-p 就是 git diff 那个逐行格式,一条提交一段。要文件清单用 --stat, 要具体改了哪几行用 -p。

这一行是哪一次加进来的

记得内容、不记得哪次提交,用 -S:

git log -S "MAX_RETRY" --oneline
6a5d89f bump version to 3 and add retry limit

-S 找的不是「提交信息里有没有这个词」,而是「这个字符串的出现次数变了」。 MAX_RETRY 只在 6a5d89f 加进来一次,所以只命中一条。

想按提交信息里的字查,换成 --grep。它默认区分大小写:

git log --oneline --grep="RETRY"
# 一行都没有 —— 提交信息里写的是小写 retry git log --oneline -i --grep="RETRY"
6a5d89f bump version to 3 and add retry limit

按人查用 --author,它认的是写这份代码的人,不是把它提交进去的人:

git log --oneline --author="Li Si"
f6495ed bump version to 2 and add util.sh

f6495ed 的作者是 Li Si,提交者仍是 Zhang San,--author 只认前者。 这几个选项能和上面的任何选项叠在一起。

改坏了一个文件,想让它变回上次提交的样子

最浅的一层:改动只在磁盘上,还没 git add。例如把 app.txt 改为 version=4:

git status -s M app.txt

M 前面有一个空格,说明它站在右列:改动在工作区,暂存区里还没有它。 退回去:

git restore app.txt
git status -s cat app.txt
version=3

git restore 成功时不打印任何东西 —— 中间那个空行就是成功。第二次 git status -s 也空了, cat 出来又是 version=3:文件回到了上次提交的样子。

文件名打错会怎样:

git restore nope.txt
error: pathspec 'nope.txt' did not match any file(s) known to git

pathspec 是 git 对「文件路径」的叫法。它按名字找,找不到就说找不到,不会猜你想退哪个文件。

这一步没有副本可退:磁盘上的改动只有一份,restore 一执行就没了。编辑器自己的撤销是唯一后路。

老写法 git checkout -- app.txt 效果一样。2.23 之后 checkout 被拆成两半: git restore 管文件内容,git switch 管切分支,一个词只做一件事。

add 错了文件,想把它从暂存区拿出来

同样把 app.txt 改成 version=4,这次 add 进去:

git add app.txt
git status -s
M app.txt

对照上一步:上一次是  M app.txt,这一次是 M  app.txt —— 同一个 M 换了一列。 左列是暂存区,右列是工作区;两个位置都可能有 M,只看它站在哪一边。

撤出暂存区:

git restore --staged app.txt
git status -s M app.txt cat app.txt
version=4

执行后:M 回到右列,文件不在缓存区;但文件的新内容一行没动,version=4 还在。 --staged 退的是候选清单,不是内容。

当你创建新文件的时候也是走的同一条路,只是标记不同: 从M变成了A

git add new.txt
git status -s
A new.txt git restore --staged new.txt git status -s
?? new.txt

A 是「新增的候选」,撤出之后变回 ??:文件还在磁盘上,只是 git 又不看它了。

老写法 git reset HEAD <文件> 做同一件事,只多打一行 Unstaged changes after reset:。

撤回Commit

这里先明确概念:指针不是提交的内容本身,它指的是提交的引用;以哈希命名的文件夹指的才是对象数据本身。HEAD 是一个指针,指向当前分支的最新提交。分支 是一条线,指向某一次提交。

这里实际上有一个误导的地方,撤销commit有两种,一种是移动当前分支和HEAD的指针到之前的某次提交,指针移动之后,那些提交变成“不可达”了;另一种是生成一个新的提交来撤销之前的提交,也就是 git revert。git reset 是移动指针,git revert 是生成新的提交。 git revert的作用就在于git reset会改变历史, 而 git revert 不会改变历史,适合已经推送到远程的提交。

A --- B --- C ← 现在:main 和 HEAD 都指向 C
A --- B ← git reset HEAD~1 之后:两者退回 B

git reset HEAD~n 回到往上数 n 个提交

git reset d250bbe 回退到 d250bbe 这次提交

git reset 有三种模式:--soft、--mixed、--hard,区别在于除了指针,还重置哪些区域。

模式

HEAD 与当前分支

暂存区

工作区

典型场景

--soft

退回 B

保留 C 的内容

保留 C 的内容

提交拆错了,改动全留着重新组织

--mixed(默认)

退回 B

退回 B

保留 C 的内容

提交早了,改动退回工作区重新挑一遍

--hard

退回 B

退回 B

退回 B

确定这批改动全部不要

三种模式回的都是 B,git log 都少一条,差别只在「除了指针,还重置哪些区域」。 下面三段来自三个一样的副本,各自跑一种模式,看 git status 就能看出区别。

--soft:

git reset --soft HEAD~1 git log --oneline
f6495ed bump version to 2 and add util.sh
64a7c45 add app and readme git status
On branch main
Changes to be committed: (use "git restore --staged <file>..." to unstage) modified: app.txt modified: util.sh

只搬指针。6a5d89f 带进来的改动原样留在暂存区,一条没丢,随时可以重新 git commit。

--mixed,不写模式名时的默认值:

git reset HEAD~1 git log --oneline
f6495ed bump version to 2 and add util.sh
64a7c45 add app and readme git status
On branch main
Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git restore <file>..." to discard changes in working directory) modified: app.txt modified: util.sh no changes added to commit (use "git add" and/or "git commit -a")

和上面那份 status 只差一个标题:Changes to be committed 变成 Changes not staged for commit。 指针退到 B,暂存区也退到 B,改动掉回工作区 —— 文件内容还是 C 那一版,所以 git diff 立刻能看见那两处修改。

--hard:

git reset --hard HEAD~1
HEAD is now at f6495ed bump version to 2 and add util.sh git status
On branch main
nothing to commit, working tree clean

三层一起回到 B:磁盘上的 app.txt 变回 version=2,MAX_RETRY 那行也没了。 这一模式丢的是工作区里没提交过的东西 —— 它没有第二份。

硬退之后还有一条捞回来的路,因为 HEAD 每动一次都会记一笔:

git reflog -4
f6495ed HEAD@{0}: reset: moving to HEAD~1
6a5d89f HEAD@{1}: commit: bump version to 3 and add retry limit
f6495ed HEAD@{2}: commit: bump version to 2 and add util.sh
64a7c45 HEAD@{3}: commit (initial): add app and readme git reset --hard 6a5d89f
HEAD is now at 6a5d89f bump version to 3 and add retry limit

HEAD@{1} 就是刚被甩掉的那条。reflog 只存在你这台机器上、只留一段时间、也只记你自己做过什么, 所以它是后路,不是备份。

已经推上去的提交不要 reset

reset 改的是本地历史:6a5d89f 从 main 上消失了。如果它已经推送、 别人可能正基于它干活,reset 之后强推会让对方手里的历史对不上。 撤销一条已推送的提交用 git revert:它生成一条内容相反的新提交,历史只增不改。

刚提交完就发现漏了文件

config.txt 忘了加,提交已经落下去了。补给最近那一条:

git add config.txt
git commit --amend --no-edit
[main 129a1c4] bump version to 3 and add retry limit Date: Fri May 1 10:00:00 2026 +0800 3 files changed, 3 insertions(+), 1 deletion(-) create mode 100644 config.txt

--no-edit 表示提交信息不动,只把暂存区里的东西补进上一次提交。前后对照一下:

git log --oneline
129a1c4 bump version to 3 and add retry limit
f6495ed bump version to 2 and add util.sh
64a7c45 add app and readme git rev-list --count HEAD
3

条数没变,还是三条;最上面那一条的哈希从 6a5d89f 变成了 129a1c4。 --amend 不修改原提交:它拿当前暂存区造一条新的,再让分支指过去,旧的那条没人指就沉下去。

只想改说明文字:

git commit --amend -m "bump version to 3"
[main 7c14a68] bump version to 3 Date: Fri May 1 10:00:00 2026 +0800 3 files changed, 3 insertions(+), 1 deletion(-) create mode 100644 config.txt

不带参数写 git commit --amend,会打开编辑器,里面是上一次的提交信息;内容仍然取当前暂存区。

推过的提交别 amend

本地没推过的提交随便改。已经推上去的,amend 等于改写远程那一条,要 force push 才盖得掉,别人拉过旧提交就会分叉。 判断标准一句话:这条提交有没有可能已经到别人手里。

到底什么东西能进仓库

以下为常见例子,实际情况可能有所不同:

类别

例子

为什么

编译产物、缓存

build/、node_modules/

能从源码重算,进仓库只让 diff 变噪

日志

app.log

本地调试用,别人不需要

本地配置

config.local

每台机器不一样

密钥、token

.env

不然会被提交到仓库里被别人使用

已经进了仓库的,ignore 拦不住

规则有一个前提:只管未跟踪的文件。用 -f 强行塞进去两个,看会发生什么:

git add -f app.log build/out.bin
git status -s
A app.log
A build/out.bin
?? .gitignore git commit -m "commit a log by mistake" git ls-files
.gitignore
README.md
app.log
app.txt
build/out.bin

保存之后再改 app.log,.gitignore 已经管不住它了:

git status -s M app.log git check-ignore -v app.log
# 没有输出,退出码 1 —— 它默认跳过已跟踪的文件

把它从索引里摘掉,磁盘上那一份不删:

git rm --cached app.log
rm 'app.log' git status -s
D app.log git ls-files
.gitignore
README.md
app.txt
build/out.bin

块里那行 rm 'app.log' 是 git 打出来的回执,不是要你敲的命令 —— 它长得像命令,位置在命令下面。

D 在第一列:这次移除已经进了暂存区,等一次提交。git ls-files 里没有 app.log 了, 磁盘上它还在。提交之后才算真脱管。

目录用同一招加 -r:

git rm --cached -r build
rm 'build/out.bin' git status -s
D app.log
D build/out.bin ls build
out.bin

--cached 只管索引,从不动工作区:build/ 目录还在磁盘上。

密钥和 token 是另一档:一旦提交并推送,它就在历史里,之后删文件也删不掉那条提交,补救只能改写历史再强推, 代价由别人承担。有效做法只有一个 —— 第一次就别提交。

这一课把「退」拆成三层,每层一个命令:git restore 退工作区,git restore --staged 退暂存区, git reset 退指针。--amend 是替换最后一次提交,.gitignore 决定哪些文件从一开始就不进来。

这几层都假设只有一条线。两条改动线要同时存在、来回切、最后合到一起 —— 那是下一课的分支与合并。