历史查看、撤销与忽略
上一课走完一条直路:改文件、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.shf6495ed 的作者是 Li Si,提交者仍是 Zhang San,--author 只认前者。 这几个选项能和上面的任何选项叠在一起。
改坏了一个文件,想让它变回上次提交的样子
最浅的一层:改动只在磁盘上,还没 git add。例如把 app.txt 改为 version=4:
git status -s M app.txtM 前面有一个空格,说明它站在右列:改动在工作区,暂存区里还没有它。 退回去:
git restore app.txt
git status -s cat app.txt
version=3git restore 成功时不打印任何东西 —— 中间那个空行就是成功。第二次 git status -s 也空了, cat 出来又是 version=3:文件回到了上次提交的样子。
文件名打错会怎样:
git restore nope.txt
error: pathspec 'nope.txt' did not match any file(s) known to gitpathspec 是 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.txtA 是「新增的候选」,撤出之后变回 ??:文件还在磁盘上,只是 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 之后:两者退回 Bgit reset HEAD~n 回到往上数 n 个提交
git reset d250bbe 回退到 d250bbe 这次提交
git reset 有三种模式:--soft、--mixed、--hard,区别在于除了指针,还重置哪些区域。
模式 | HEAD 与当前分支 | 暂存区 | 工作区 | 典型场景 |
|---|---|---|---|---|
| 退回 B | 保留 C 的内容 | 保留 C 的内容 | 提交拆错了,改动全留着重新组织 |
| 退回 B | 退回 B | 保留 C 的内容 | 提交早了,改动退回工作区重新挑一遍 |
| 退回 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 limitHEAD@{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 才盖得掉,别人拉过旧提交就会分叉。 判断标准一句话:这条提交有没有可能已经到别人手里。
到底什么东西能进仓库
以下为常见例子,实际情况可能有所不同:
类别 | 例子 | 为什么 |
|---|---|---|
编译产物、缓存 |
| 能从源码重算,进仓库只让 diff 变噪 |
日志 |
| 本地调试用,别人不需要 |
本地配置 |
| 每台机器不一样 |
密钥、token |
| 不然会被提交到仓库里被别人使用 |
已经进了仓库的,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 决定哪些文件从一开始就不进来。
这几层都假设只有一条线。两条改动线要同时存在、来回切、最后合到一起 —— 那是下一课的分支与合并。