Git 教学工作区 · 速查卡 · 撤销与回退 · 2026-10-16 · 实测环境 git 2.53.0.windows.2

撤销与回退:选哪条命令

先问两个问题,命令就唯一了: ① 要撤的东西提交了吗?没提交 → 只在 git restore 与 git reset 里选;已提交 → 看② ② 这个提交推送出去了吗?没推送 → git reset 改历史;推送过 → 只能用 git revert(它不改历史,只追加一个反向提交)。

1. 选择表:场景 → 命令 → 动的是哪棵树

「工作区 / 暂存区 / 历史」三列指这条命令会改变哪一份数据;写「不变」就是完全不动。 表中每行都在本卡第 2~7 段的实测里出现过。

场景命令工作区暂存区历史(提交)
手滑改了文件,还没 add,想还原 git restore a.txt 还原成暂存区那版不变不变
add 错了文件,想撤回暂存但保留改动 git restore --staged a.txt 不变退回 HEAD 那版不变
只想还原文件里某几块改动 git restore -p a.txt 逐块询问后还原不变不变
让工作区某文件回到历史某版 git restore --source=HEAD~1 -- a.txt 填入旧内容(并显示为已改动)不变不变
提交早了:撤回提交,改动保持已暂存 git reset --soft HEAD^ 不变不变分支指针退一格
撤回提交,改动退回工作区(默认) git reset HEAD^(= --mixed) 受影响的文件变成已改动退回 HEAD分支指针退一格
这次提交整个不要了,改动也扔 git reset --hard HEAD^ 被覆盖,未提交改动消失退回 HEAD分支指针退一格
已推送的提交要撤销 git revert <哈希> 变更被反向应用干净原历史不动,追加一个反向提交
提交信息写错 / 漏加文件,还没推送 git commit --amend 不变先 git add 补齐该提交被替换(新哈希)
合并/变基中途想退出 git merge --abort 回到操作前回到操作前不变
刚做完 reset 就后悔 git reset --hard ORIG_HEAD 回到 reset 前回到 reset 前指针回到 reset 前
提交被 reset 掉,想找回来 git reflog 查哈希 → git reset --hard <哈希> 回到该提交回到该提交指针指过去
手头改动想先挪开一会儿 git stash push -m "说明" 改动被收走收走不变(存进 refs/stash)

2. git restore:只管文件,永远不动历史

restore 的来源树由 --source 指定:省略 = 暂存区;--staged 时省略 = HEAD。

# 场景:改了 a.txt,还没 add
git status --short
#  M a.txt

git restore a.txt
git status --short
# (无输出 —— 三棵树又一致了)

# 场景:add 之后反悔,但改动要留着
printf 'line 1\nline 2 暂存了\n' > a.txt
git add a.txt
git status --short
# M  a.txt

git restore --staged a.txt
git status --short
#  M a.txt          ← 暂存区退回 HEAD,工作区的内容没动
cat a.txt
# line 1
# line 2 暂存了

# 只撤其中一块(交互式,实测提示语)
printf 'line 1\nline 2 分两块改\n' > a.txt
printf 'y\n' | git restore -p a.txt
# (1/1) Discard this hunk from worktree [y,n,q,a,d,e,p,P,?]?
#   ↑ y=丢掉这块 n=留 q=退出 a=全丢 d=全留 e=手工编辑 ?=帮助
git status --short
# (无输出)

# 用历史版本填回工作区(改回上一版内容,但仍显示为"已改动")
git restore --source=HEAD~1 -- a.txt
git status --short
#  M a.txt

3. git reset:三个模式,差别只在「动几份数据」

三种模式都做同一件事:把当前分支指针移到目标提交;区别在于顺带清不清暂存区和工作区。

模式分支指针暂存区工作区典型用途
--soft移动不动不动把一次提交拆成两次、改提交信息
--mixed(默认)移动清成目标提交的内容不动撤回提交,重新挑要提交的文件
--hard移动清成目标提交的内容覆盖彻底扔掉这段工作

实测(同一个仓库、同一次提交,依次三种模式):

git log --oneline
# 9df5d5d 第三次提交:改 a.txt
# 5eb88a7 第二次提交:加入 c.txt
# 7d5520f 首次提交:加入 a.txt 与 b.txt

# ① --soft:输出为空,改动原封不动躺在暂存区
git reset --soft HEAD^
git status --short
# M  a.txt
cat a.txt
# line 1
# line 2 第三次

# ② --mixed(默认,不写参数就是这个):改动掉回工作区
git reset HEAD^
# Unstaged changes after reset:
# M	a.txt
git status --short
#  M a.txt

# ③ --hard:输出明确告诉你落到了哪个提交
git reset --hard HEAD^
# HEAD is now at 5eb88a7 第二次提交:加入 c.txt
git status --short
# (无输出)
cat a.txt
# line 1
# line 2               ← 改动被彻底扔掉

两个必须知道的边界(都实测过)

4. reset 还是 revert:看有没有推送

git resetgit revert
对历史做什么移动分支指针,旧提交脱离分支(仍留在 reflog)不动旧提交,新增一个「反向应用」的提交
哈希会变吗会:后续提交等于被换掉不会:老提交原样保留
能对已推送的提交用吗不能:别人手上的历史和你分叉,再推要强推可以:这是共享分支的标准做法
典型场合本机、只有自己、还没推已经 push、别人可能已经拉过

动手之前,先看清「历史被改 / 分叉了」之后 push 的原话(实测,本地裸仓库当 origin,两边各多一个提交):

git push origin main
# To C:/Users/23652/AppData/Local/Temp/orig.git
#  ! [rejected]        main -> main (non-fast-forward)
# error: failed to push some refs to 'C:/Users/23652/AppData/Local/Temp/orig.git'
# hint: Updates were rejected because the tip of your current branch is behind
# hint: its remote counterpart. If you want to integrate the remote changes,
# hint: use 'git pull' before pushing again.
# hint: See the 'Note about fast-forwards' in 'git push --help' for details.

reset / --amend 之后 push 撞的就是同一堵墙:non-fast-forward。 新手对照表里写的「用 git pull」在这里不解决问题 —— 本地历史已经是另一条线, pull 只会把两条线搅在一起(或再冲突一次)。要么改用 revert,要么在明确知道没人拉过时强推 (git push --force-with-lease,本卡不推荐默认使用)。

实测 git revert(撤销刚做的那个提交):

git revert --no-edit HEAD
# [main f51bda9] Revert "补上:把提交信息改对"
#  Date: Fri Oct 16 22:22:03 2026 +0800
#  1 file changed, 1 insertion(+), 1 deletion(-)

git log --oneline
# f51bda9 Revert "补上:把提交信息改对"      ← 新提交,历史往前长
# 27c0277 补上:把提交信息改对              ← 被撤销的那个还在
# 9df5d5d 第三次提交:改 a.txt

git log -1 --pretty="%h %s%n%b"
# f51bda9 Revert "补上:把提交信息改对"
# This reverts commit 27c0277ed82f0064580e8da5c29114e446111795.
#   ↑ 提交信息由 Git 自动生成,正文里写明撤销的是哪一个哈希

边界(--no-edit 省掉编辑器,可改信息;撤销合并提交要 -m 1 指定保留哪一边的父提交): 本卡没实测合并提交的 revert,只按 git-revert 手册描述 —— git revert -m 1 <合并提交> 表示「以第 1 个父提交为基线反向应用」。

5. git commit --amend:改写最近一次提交

git log --oneline
# 9b582c7 手滑:提交信息写错了
# 9df5d5d 第三次提交:改 a.txt

git commit --amend -m "补上:把提交信息改对"
# [main 27c0277] 补上:把提交信息改对
#  Date: Fri Oct 16 12:00:00 2026 +0800
#  1 file changed, 1 insertion(+), 1 deletion(-)

git log --oneline
# 27c0277 补上:把提交信息改对
# 9df5d5d 第三次提交:改 a.txt
#   ↑ 9b582c7 那个哈希已经不在分支上:amend 是"造个新的替掉旧的"

6. git reflog:最后的找回手段

HEAD 每移动一次(提交、reset、amend、revert、切换分支)都会留一条记录,只在本机、默认保留 90 天。

git reflog
# f51bda9 HEAD@{0}: revert: Revert "补上:把提交信息改对"
# 27c0277 HEAD@{1}: commit (amend): 补上:把提交信息改对
# 9b582c7 HEAD@{2}: commit: 手滑:提交信息写错了
# 9df5d5d HEAD@{3}: reset: moving to ORIG_HEAD
# 5eb88a7 HEAD@{4}: reset: moving to HEAD^
# 9df5d5d HEAD@{5}: commit: 第三次提交:改 a.txt
# 7d5520f HEAD@{13}: commit (initial): 首次提交:加入 a.txt 与 b.txt
#   ↑ 左列哈希 + HEAD@{n}(n 是"往回数第几次") + 动作 + 说明

# 想要真实时间而不是 @{0} 编号:
git reflog --date=iso
# f51bda9 HEAD@{2026-10-16 12:10:00 +0800}: revert: Revert "补上:把提交信息改对"

# 找回流程(实测:先故意退两格,再捞回来)
git reset --hard HEAD~2
# HEAD is now at 9df5d5d 第三次提交:改 a.txt
git reflog | head -3
# 9df5d5d HEAD@{0}: reset: moving to HEAD~2
# f51bda9 HEAD@{1}: revert: Revert "补上:把提交信息改对"    ← 丢掉的那个就在这儿

git reset --hard f51bda9
# HEAD is now at f51bda9 Revert "补上:把提交信息改对"
#   ↑ 或者更稳:git branch 救回 f51bda9  (留个分支,再慢慢看)
问题答案
reflog 保留多久默认 90 天(gc.reflogExpire);其中「已不可达」的记录默认 30 天(gc.reflogExpireUnreachable)
换台机器还能查吗不能。reflog 是本机日志,刚从远端克隆下来的仓库里只有本地操作产生的那几条
记录被 gc 清了怎么办用 git fsck --lost-found 找悬空对象,能捞回的对象写在 .git/lost-found/ 下;成功率低于 reflog
对象还在但记录没了只要哈希还记得(比如贴过日志),git cat-file -p <哈希> 就能确认它还在

7. 旧写法与变体(效果相同,新脚本里别再写)

旧写法等价的新写法实测
git checkout -- a.txtgit restore a.txt两者跑完 git status --short 都由 M a.txt 变成无输出
git reset HEAD -- a.txtgit restore --staged a.txt由 M a.txt 变成 M a.txt,内容不变
git checkout <哈希>(进分离头指针)git switch --detach <哈希>语义相同;新命令把「切分支」和「切提交」分开表述
git reset --hard 清一批工作区改动逐个 git restore <路径>后者只动指定路径,不会误伤同目录其它文件

8. git stash:改动先挪开(实测行为)

git status --short
#  M a.txt
# ?? tmp.txt

git stash push -m "临时收起来"
# Saved working directory and index state On main: 临时收起来
git status --short
# ?? tmp.txt          ← 默认不碰未跟踪文件,tmp.txt 还在原地
git stash list
# stash@{0}: On main: 临时收起来

git stash pop
# On branch main
# Changes not staged for commit:
# 	modified:   a.txt
# Untracked files:
# 	tmp.txt
# Dropped refs/stash@{0} (25ca6ca0a1f3dc04f89a7ca4fdf24890d521cb61)

# 要连未跟踪一起收:git stash push -u -m "连未跟踪一起收"
#  实测:执行后 tmp.txt 从磁盘消失("No such file or directory"),pop 后回来

stash 不改历史,存的是 refs/stash 这个引用下的提交对象;误删可用 git fsck 找, 或看 git-stash 手册的 list / apply / drop。

9. 危险清单

命令会丢什么防呆做法
git reset --hard未提交的工作区改动;已 add 未提交的新文件先 git stash push -u,或先 git status --short 确认没有 A/M 行
git clean -fd未跟踪文件与目录(实打实删磁盘)先 git clean -nd 干跑看要删什么
git reset / --amend(已推送)别人的历史与你的分叉已推送就改用 git revert
git checkout <文件>(在分离头指针里)看着像回退,其实不是;容易误判当前在哪用 git switch / git restore 明确区分
git stash pop 之后又 stash dropstash 里那份改动先 pop 确认无误再 drop;reflog 里通常还找得到

实测「先干跑」这一步长什么样(未跟踪文件未提交时):

git clean -nd
# Would remove junk.txt
# Would remove junkdir/
#   ↑ -n 只列不删;-nd 会带目录;确认无误再换成 -qfd 真删

自测

1. 已经 git push 的提交里有段代码要撤掉,用哪条?

对。前三个都会重写哈希:别人已经拉过的历史一改就分叉,再推得强推。revert 只追加新提交,是共享分支上唯一安全的撤法。

2. git reset --soft HEAD^ 之后,刚才那次提交的改动在哪?

对。--soft 只把分支指针往回挪,index 与工作区都不动,所以那次提交的内容仍是"已暂存"状态 —— 直接 git commit 就能换个信息重提。

3. 误跑了 git reset --hard HEAD~3,三个提交从分支上消失。首选怎么救?

对。reset 只移动指针,旧提交还在 .git/objects 里,reflog 记着移动前的哈希(或直接 git reset --hard ORIG_HEAD)。这也是为什么「丢了东西先别乱敲,先看 reflog」。