主线 · 第 6 / 8 篇
· 约 8 分钟
改错了怎么办:restore、reset 和 revert 各动了哪一层
restore 只动文件,不动分支;reset 改的是分支的指向,再按模式决定要不要连暂存区和工作区一起改;revert 不改历史,用一个新提交抵消旧提交。真正会丢东西的,是覆盖了还没提交的内容。
改错了想撤回,Git 给了三个名字很像的命令:restore、reset、revert。常见的疑问是:它们有什么区别?reset --hard 为什么总被说危险?已经推送的提交还能用 reset 撤吗?把前几篇的三处(工作区、暂存区、HEAD)和“分支是名字”放在一起看,三个命令各动了哪一层,就清楚了。
三个名字相近的命令
Git 的总文档里专门有一节讲这三个命令,大意如下:
| 命令 | 动的是什么 | 改不改历史 |
|---|---|---|
git restore | 用暂存区或某个提交里的内容恢复文件 | 不改,分支不动 |
git reset | 改当前分支指向哪个提交,也可以顺带恢复暂存区 | 改,提交会从分支上加进来或拿掉 |
git revert | 新建提交,抵消某些旧提交带来的改动 | 不改已有的,只往后加 |
接着用前几篇的演示仓库:first、second 之后又多了一个提交 b36a400,在 README.md 末尾加了一行 oops,这是要撤回的“坏提交”。
restore:只动文件
先把 README.md 删了,git status --short 显示 D README.md。执行 git restore README.md,文件回来了,内容和暂存区里的一样。第二篇说过,不加 --staged 时,restore 用暂存区的内容恢复工作区。
也可以从别的提交里取:git restore --source=HEAD~2 README.md 把文件换成 first 那个版本,只有 hello 一行。HEAD~2 表示沿第一父提交往前两代,HEAD~ 是往前一代。这时状态是 M README.md,main 仍然指向 b36a400。restore 改的只是文件,分支和历史都没动。oh-my-git 讲“出了岔子”的一组关卡,前两关就是这两种情况:找回删掉的文件,找回旧提交里的文件。关卡里用的是更早的 git checkout <提交> <文件>,效果相同。
需要留意的是它会覆盖。给 README.md 加一行文字 unsaved(没有 add,也没有提交),再 git restore README.md,这一行就没了。Pro Git 讲撤消操作时特别提醒过同样的事:用最近提交的版本覆盖文件,本地的修改都会消失,除非确实不要了,否则别用。restore 不会先问一句。
reset:改的是分支指向
reset 和 restore 的根本区别在于它先动分支。Pro Git 把 reset 拆成三步:第一步,让 HEAD 指向的分支改成指向目标提交;第二步,用这个提交的快照更新暂存区;第三步,让工作区和暂存区一致。三个模式就是在不同的步骤停下:
| 写法 | 分支 | 暂存区 | 工作区 | 演示后的状态 |
|---|---|---|---|---|
git reset --soft HEAD~ | 改指向 second | 不动 | 不动 | M README.md |
git reset HEAD~ | 改指向 second | 改成 second 的版本 | 不动 | M README.md |
git reset --hard HEAD~ | 改指向 second | 改成 second 的版本 | 改成 second 的版本 | 干净 |
不写模式时默认是 --mixed,也就是第二行。三种情况下 main 都从 b36a400 改成了 86c0fab,区别只在 oops 那一行留在哪里。--soft 之后它还在暂存区里,状态是左列的 M,相当于撤回了 commit 这一步;--mixed 之后它只在工作区,相当于连 add 也撤回了;--hard 之后哪里都没有了。
oh-my-git 里撤回坏提交那一关用的就是不带参数的 reset:分支回到上一个提交,暂存区也跟着回去,工作区不动,改好再重新提交。
第三篇提过分支可以挪到别的提交上,用的就是 reset。它和 git switch 的区别是:switch 改的是 HEAD 指向哪个分支,reset 改的是当前分支指向哪个提交。
哪些操作会真的丢东西
回头看被 reset 拿掉的 b36a400:用 git cat-file -t 查,它还是一个 commit。和删分支、游离 HEAD 留下的提交一样,只是 main 不再指向它。Pro Git 的说法是:在 Git 里,任何已提交的东西几乎总是可以恢复的,被删除的分支上的提交、被 amend 覆盖的提交都可以;但没有提交过的东西,丢了以后很可能再也找不回来。
所以危险的不是“撤回提交”,而是覆盖工作区里还没提交的内容。按 Pro Git,--hard 是 reset 唯一危险的用法,也是 Git 少数会真正销毁数据的操作之一,因为它强制覆盖了工作区的文件。演示里,先给 README.md 加一行 unsaved,再新建一个没有跟踪的 new.txt,然后 git reset --hard HEAD~:
$ git status --short
M README.md
?? new.txt
$ git reset --hard HEAD~
HEAD is now at 86c0fab second
$ git status --short
?? new.txt
unsaved 那一行没了,而且找不回来:它从没进过暂存区,也就从没存成对象。new.txt 还在,因为目标提交里没有这个路径,reset 不管它。
未跟踪文件也不是总安全,关键看它是否挡住了目标提交里的路径。git-reset 文档写明 --hard 可能覆盖未跟踪文件。演示里再造一个情况:某个提交里有 clash.txt,工作区里也有一个同名、未跟踪的 clash.txt。git switch 到那个提交会拒绝,提示 untracked working tree files would be overwritten;git reset --hard 到那个提交则直接覆盖,工作区里那份内容就没了。
照这个思路,先分清要找回的是提交,还是未提交的内容。--soft、--mixed、删分支、amend 都不覆盖工作区,被换下的提交在对象尚未清理时通常还能找回。不过 --mixed 会重置暂存区:暂存过后又改过的文件,那份中间版本未必还在工作区。reset --hard、不带 --staged 的 restore、git checkout -- <文件> 则会覆盖工作区,未提交的内容可能直接丢失。操作前先看 git status 和两种 diff,确认哪些内容还要保留。
revert:用新提交抵消
前面几种都只在本地有效。坏提交已经推送,别人可能已经基于它开发,用 reset 拿掉它就是改写共享的历史,推送时会被拒绝,只能强推,正是上一篇说的那种覆盖。oh-my-git 在“推送了坏东西”那一关给的答案是 revert。
git-revert 文档的说法是:给定已有的提交,把它们带来的改动反过来,记成新的提交。演示里:
$ git revert --no-edit HEAD
[main e60d910] Revert "bad change"
$ git log --oneline
e60d910 Revert "bad change"
b36a400 bad change
86c0fab second
b6c8214 first
坏提交还在历史里,后面多了一个提交,内容是删掉 oops 那一行。新提交的树是 894c6d8,和 second 的树完全相同,第一篇和第二篇都见过这个哈希。文件回到了 second 的样子,历史却只往后加了一个提交,推送时就是普通的快进。
文档还提了两点。revert 要求工作区是干净的;如果只是想丢掉未提交的改动,该用的是 reset,而不是 revert。
怎么选
可以按要撤回的东西在哪一层来选。只是文件改坏了,还没提交,用 restore,代价是丢掉那些改动。提交了但还没推送,用 reset,按需要选模式,想保留改动就别用 --hard。已经推送,用 revert,让撤回本身也成为一次可以推送、可以再撤回的提交。
审 AI 的 Git 操作时,先看它用的是三个里的哪一个,再看动了哪一层。它说“回滚了”,要问清是 reset 还是 revert:前者改了分支指向,推送过的分支接下来就要强推;后者只是多了一个提交。看到 reset --hard 或不带 --staged 的 restore,执行之前先确认工作区里没有还要的改动。
参考资料
- git:Reset, restore and revert 一节,三个命令各管什么。
- Pro Git:重置揭密:reset 的三步,
--hard是唯一危险的用法。 - Pro Git:撤消操作:覆盖本地修改的命令要慎用,已提交的几乎总能恢复,未提交的丢了很可能找不回。
- git-reset:
--soft、--mixed、--hard分别改什么,默认是--mixed。 - git-restore:默认从暂存区恢复工作区,
--source指定其他提交。 - git-revert:用新提交反转旧提交的改动,要求工作区干净。
- oh-my-git:shit-happens 一组关卡,找回文件、撤回坏提交、推送了坏东西。
本文涉及的知识点
8 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。