在实际开发和练习使用 worktree、cherry-pick、rebase 的过程中,最常令人产生顾虑的问题是“一旦改错了文件、合乱了分支或者误删了提交,该怎么安全撤回而不丢代码”。很多初学者觉得 Git 撤销命令繁杂,往往是因为试图用一个通用命令解决所有撤回需求。
实际上,撤销操作之所以分为 restore、reset 与 revert 三条路径,直接取决于你要撤销的代码正处于生命周期的哪一个阶段:是还在工作区或暂存区里尚未提交的修改、是已经提交但还留在自己电脑上的本地提交,还是已经 push 到远程仓库、队友也已经拉取下去的公共历史。理清了阶段边界,再结合底层的本地操作日志 git reflog,绝大多数误操作都可以精确找回。
git restore如果改错的代码还没有执行 git commit,它此刻只存在于第一章介绍的工作区或暂存区里,根本没有进入版本历史链条,自然不需要动用分支指针。这种阶段一律使用作用于单个文件粒度的 git restore 命令:
git add,想把文件退回工作区:运行 git restore --staged <文件名>。这条命令只把指定文件从暂存区清单里移除,你在编辑器里辛辛苦苦写好的代码修改会完好保留在工作区文件夹里,不会被覆盖。git restore <文件名>。Git 会直接用暂存区(或最近一次提交)里的正常版本覆写硬盘上的该文件。这里必须注意一条不可逆警告:因为这些工作区修改从未执行过 git add 和 git commit,它们从来没有写入 .git/objects/ 对象库;一旦用 git restore <文件名> 覆盖掉,Git 无法再帮找回。git reset 的三种模式如果你已经执行过一两次 git commit,但这些提交还没有 git push 到团队共享的远程分支上,此时你发现刚才那几次提交写得不够好,想让当前分支的指针直接退回到更早的版本(例如退回 1 步用 HEAD~1,退回 2 步用 HEAD~2,或者直接写目标 Commit 的短哈希),就可以使用 git reset。
git reset 总是会先将当前分支的指针向后移动到目标版本;它的三个参数 --soft、--mixed 和 --hard,唯一区别在于退回指针的同时,原来那几步写的代码修改是保留在暂存区、留在工作区,还是连同工作区文件一并退回旧快照:
git reset --soft HEAD~1:只把当前分支指针退回上一版本,既不动暂存区,也不动工作区文件。结果就是“那次提交里的所有代码修改都原封不动放在暂存区里”。这种模式最适合在刚提交完就发现漏改了一处细节,或者想把最近两三次零碎提交重新整合为一次整洁提交时使用。git reset HEAD~1(默认等价于 --mixed):在退回分支指针的同时,把暂存区清单也退回到上一版本的样子,但工作区磁盘文件保持不变。也就是说,刚才提交过的所有修改依然完整留在硬盘文件里,处于“已修改但未暂存”状态,方便你重新用 git add 挑选提交范围。git reset --hard HEAD~1:同时重置分支指针、暂存区以及工作区里所有已受版本控制的文件,使整个目录瞬间恢复成上一个历史版本一模一样的干净快照。
图 1:从已提交版本 V2 执行三种 git reset HEAD~1 回退至 V1 时,工作区、暂存区、HEAD 指针的变化层级与对应的 git status 输出对比。
在使用 --hard 时,应当牢牢记住一条最关键的安全界线:凡是已经通过 git commit 存入对象库的版本,即便被 reset --hard 从分支历史里退掉了,那些快照对象依然完整躺在 .git/objects/ 里(可以通过第四节的 reflog 找回);但工作区里那些从来没有 add 或 commit 过的本地未保存修改,一旦遭遇 --hard 覆写就会彻底消失。因此养成一个稳妥习惯:只要不确定接下来要做的重置或变基是否会搞乱当前状态,先随手在工作区做一次临时 git commit,或另开一个 worktree 去操作,即可将丢代码的风险降为零。
git revert当一个包含缺陷的提交 C 已经被 git push 推送到团队共用的 main 分支后,情况就截然不同了。此时绝对不要在公共分支上用 git reset 把分支指针往回拽——因为同事电脑上的本地分支已经包含提交 C,你强行改写远程历史会迫使团队所有人遇到历史分叉冲突。
正确做法是使用 git revert <C的哈希>。它的处理思路与 reset 完全相反:不擦除任何已经公开的历史记录,而是在分支末尾追加一个新的提交 R,专门把当初提交 C 造成的改动“反着做一遍”抵消掉。举例来说,如果当初提交 C 在第 12 行新增了三行逻辑并删掉了一行旧代码,那么 git revert C 在内部做的事情恰好与第四章的 cherry-pick 互为镜像:把对比起点设为 C 自身,把目标设为它的上一版本 C^,算出从 C 回到 C^ 的逆向补丁,再叠加到当前最新分支末端,生成新提交 R。执行之后历史只向前走而不倒退,直接正常运行 git push 即可安全同步给全团队。
图 2:上半部分对比代码处于工作区、本地私有提交与公共远程分支三个阶段时分别对应的撤销命令;下半部分展示即使因 reset --hard 脱离分支链路,本地引用日志依然能够精准定位原对象。
如果发现需要整体撤回的那次提交恰好是一个双父节点的合并提交 M,与 cherry-pick 的原理完全相同,直接运行 git revert <M> 会因父版本不唯一而失败,需要附加 -m 1(git revert -m 1 <M>)指明保留第 1 父版本(即主干线)并撤回第 2 父版本(被并入的功能分支)带来的全部变动。此外,回滚合并提交在团队协作中有一个经典的后续注意点:虽然主干代码内容已经恢复原样,但在提交图里,那条功能分支原来的提交记录依然算作主干历史的一部分;假如几天后你在原功能分支上又补了一个修复并试图再次合并回 main,Git 会认为早期那些提交早就在主干历史里出现过了,从而只合入最新一次修复而跳过早期代码。要重新启用那批改动,最直接的方法是在再次合并前先在 main 上执行一次 git revert <R>(撤销掉此前的那次撤销),或者在功能分支上通过重新 rebase 换出全新哈希后再发起合并。
git reflog 本地操作日志即使不小心在终端里误敲了 git reset --hard HEAD~3 把几天的提交从 git log 里抹掉,或者在 rebase 过程中操作乱套,甚至用 git branch -D 强行删掉了一条还没合并的分支,只要这些内容曾经执行过 git commit,几乎总能在几秒钟内完整恢复。
之所以能够找回,基于第一章和本节的两项机制协同:一方面,.git/objects/ 中的文件与提交对象在分支指针移动时不会被立即删除;另一方面,只要你在这台电脑上移动过 HEAD 指针或分支位置——无论是执行 commit、switch、reset、cherry-pick、merge 还是 rebase——Git 都会默默以追加写入的方式,把这一次移动前后的 Commit 哈希与操作名称记录在本地的 .git/logs/HEAD 文件中。这就是 引用日志(Reflog)。需要记住两点特性:第一,reflog 只记录在你自己的本地电脑上,既不会被 push 到远程,也不会被 fetch 下来;第二,对于这种脱离了任何分支指针指向的悬空提交记录,Git 默认会在本地安全保留 30 天(正常可达分支的操作日志默认保留 90 天),远在垃圾回收清理它们之前就有充足时间恢复。
标准找回流程只需两步:
查看近期本地操作轨迹,锁定误操作前那一刻:在发生误操作的仓库目录运行 git reflog -n 10,终端会按时间倒序列出最近的操作记录:
7b3f686 (HEAD -> main) HEAD@{0}: reset: moving to HEAD~2
a5989e6 HEAD@{1}: commit (cherry-pick): fix(validator): trim whitespace
fdab0ed HEAD@{2}: checkout: moving from feat-profile to main
从输出中可以一眼定位:当前错误的现状是编号 HEAD@{0} 的那次 reset,而紧邻它下面、误操作之前的正确状态就是编号 HEAD@{1} 对应的提交 a5989e6。
核对并恢复分支位置:如果当时工作区是干净的,直接执行 git reset --hard HEAD@{1},分支指针与代码立刻还原到误重置前的一瞬间。如果不确定 a5989e6 到底是不是你想要的那一版,还可以采用完全非破坏性的方式先检查一遍:直接运行 git branch recover a5989e6 把那个脱离链条的提交重新挂到一个新分支名上,或者配合第三章的隔离目录 git worktree add --detach ../wt-check a5989e6 在旁路目录里核对源码与编译测试结果,确认无误后再切回或合并。至此,整个从本地基础存储、多目录工作树、提交拣选变基到完整灾难恢复的 Git 体系便已形成闭环。