17. 从分支移除提交

目标

  • 学习如何从分支移除最近的提交。

上一小节的 revert 是一个让我们撤销仓库中的任意提交的强大命令。 然而,原始提交和“撤销”提交在分支历史中都可见(使用 git log 命令)。

经常我们提交代码,然后很快意识到犯了错误。如果有一个“收回”命令能允许我们假装不正确的提交从未发生过该多好啊。 “收回”命令甚至还会阻止错误的提交在 git log 历史中的显示。这就像错误的提交从未发生过一样。

重置命令

我们已经介绍过 reset 命令,并用它来设置暂存区以便与特定的提交保持一致(我们在之前的实验中使用 HEAD 提交)。

当给定提交引用(如哈希值、分支或标签名)时,reset 命令将:

  1. 重写当前分支到指向的特定提交

  2. 重置暂存区到匹配特定的提交(可选)

  3. 重置工作目录到匹配特定的提交(可选)

检查历史

让我们快速地查看我们的提交历史。

$ git hist

输出:

$ git hist
* 8c2f695 2019-11-01 | Revert "Oops, we didn't want this commit" (HEAD -> master) [Jim Weirich]
* d5723b3 2019-11-01 | Oops, we didn't want this commit [Jim Weirich]
* 4d578d4 2019-11-01 | Added a comment (tag: v1) [Jim Weirich]
* dc1d42f 2019-11-01 | Added a default value (tag: v1-beta) [Jim Weirich]
* 9a1c494 2019-11-01 | Using ARGV [Jim Weirich]
* 063b40e 2019-11-01 | First Commit [Jim Weirich]

我们看到在该分支中的最后两个提交为 “Oops” 和 “Revert Oops”。让我们使用 reset 来移除它们。

首先,标记分支

但在我们移除提交前,让我们使用一个标签来标记最新的提交以便能够再次找到它。

$ git tag oops

重置到 “Oops” 前

看看上面的日志历史,我们可以知道标记为“v1”的提交是错误提交之前的正确提交。 让我们重置分支到该位置。因为分支已经标记,所以我们可以在 reset 命令中使用标签名( 如果它没有被标记,那么我们只能使用哈希值)。

$ git reset --hard v1
$ git hist

输出:

$ git reset --hard v1
HEAD is now at 4d578d4 Added a comment
$ git hist
* 4d578d4 2019-11-01 | Added a comment (HEAD -> master, tag: v1) [Jim Weirich]
* dc1d42f 2019-11-01 | Added a default value (tag: v1-beta) [Jim Weirich]
* 9a1c494 2019-11-01 | Using ARGV [Jim Weirich]
* 063b40e 2019-11-01 | First Commit [Jim Weirich]

我们的 master 分支现在指到 v1 提交,并且 “Oops” 和 “Revert Oops” 提交已经不在分支中。 --hard 参数表示应当更新工作目录以便与新的分支头保持一致。

什么也没丢

但错误的提交发生了什么?结果是提交仍然在仓库中。事实上,我们仍然能够引用它们。 记得在本实验开始我们使用标签 oops 标记了还原的提交。 让我们看看所有的提交。

$ git hist --all

输出:

$ git hist --all
* 8c2f695 2019-11-01 | Revert "Oops, we didn't want this commit" (tag: oops) [Jim Weirich]
* d5723b3 2019-11-01 | Oops, we didn't want this commit [Jim Weirich]
* 4d578d4 2019-11-01 | Added a comment (HEAD -> master, tag: v1) [Jim Weirich]
* dc1d42f 2019-11-01 | Added a default value (tag: v1-beta) [Jim Weirich]
* 9a1c494 2019-11-01 | Using ARGV [Jim Weirich]
* 063b40e 2019-11-01 | First Commit [Jim Weirich]

在这儿我们看到错误的提交并没有消失。它们仍然在仓库中。它们只是不再列到 master 分支中。 如果我们没有标记它们,它们依然在仓库中,但除了使用哈希值外没有别的方法引用它们。 未引用的提交保留在仓库中,一直到系统运行垃圾回收时。

重置的危险性

在本地分支上重置一般是安全的。任何“事故”通常都能通过重置到想要的提交来恢复。

然而,如果分支在共享的远程仓库上,那么重置可能使其他用户共享的分支混乱。