一般来说,git reset 的功能是获取当前分支并将其重置为指向其他地方,并可能将索引和工作树一起带上。更具体地说,如果您的主分支(当前已签出)是这样的:
- A - B - C (HEAD, master)
并且你意识到你希望 master 指向 B,而不是 C,你将使用 git reset B 将它移动到那里:
- A - B (HEAD, master) # - C is still here, but there's no branch pointing to it anymore
题外话:这与结帐不同。如果你运行git checkout B,你会得到这个:
- A - B (HEAD) - C (master)
您最终处于分离的 HEAD 状态。 HEAD,工作树,索引都匹配B,但主分支留在C。如果此时你进行新的提交 D,你会得到这个,这可能不是你想要的:
- A - B - C (master)
\
D (HEAD)
请记住,reset 不会进行提交,它只是更新一个分支(它是一个提交的指针)以指向不同的提交。其余的只是您的索引和工作树发生的情况的详细信息。
用例
我在下一节对各种选项的描述中介绍了git reset 的许多主要用例。它真的可以用于各种各样的事情;共同点是所有这些都涉及重置分支、索引和/或工作树以指向/匹配给定的提交。
注意事项
--hard 会导致你真的丢掉工作。它会修改您的工作树。
git reset [options] commit 可能会导致您(在某种程度上)丢失提交。在上面的玩具示例中,我们丢失了提交 C。它仍在 repo 中,您可以通过查看 git reflog show HEAD 或 git reflog show master 找到它,但实际上不再可以从任何分支访问它。
Git 会在 30 天后永久删除此类提交,但在此之前,您可以通过再次将分支指向它来恢复 C (git checkout C; git branch <new branch name>)。
参数
解释手册页,最常见的用法是git reset [<commit>] [paths...] 形式,它将给定路径从给定提交重置为其状态。如果未提供路径,则重置整个树,如果未提供提交,则将其视为 HEAD(当前提交)。这是 git 命令中的常见模式(例如 checkout、diff、log,尽管确切的语义有所不同),所以应该不会太令人惊讶。
例如,git reset other-branch path/to/foo 将 path/to/foo 中的所有内容重置为其在 other-branch 中的状态,git reset -- . 将当前目录重置为其在 HEAD 中的状态,而简单的 git reset 将所有内容重置为其在其中的状态头。
主要工作树和索引选项
有四个主要选项可以控制在重置期间您的工作树和索引会发生什么。
记住,索引是 git 的“暂存区”——当你说 git add 准备提交时,它就是事情发生的地方。
-
--hard 使所有内容都与您重置的提交相匹配。这可能是最容易理解的。您的所有本地更改都会被破坏。一个主要用途是消除您的工作,但不切换提交:git reset --hard 表示 git reset --hard HEAD,即不更改分支但摆脱所有本地更改。另一种是将分支从一个地方移动到另一个地方,并保持索引/工作树同步。 这是一个真正让你失去工作的人,因为它会修改你的工作树。在你运行任何reset --hard之前,一定要放弃本地工作。
--mixed 是默认值,即git reset 表示git reset --mixed。它会重置索引,但不会重置工作树。这意味着您的所有文件都是完整的,但是原始提交和您重置的文件之间的任何差异都将显示为带有 git 状态的本地修改(或未跟踪的文件)。当你意识到你做了一些错误的提交时使用这个,但你想保留你所做的所有工作,以便你可以修复它并重新提交。为了提交,您必须再次将文件添加到索引中 (git add ...)。
--soft 不会触及索引或工作树。您的所有文件都与--mixed 一样完好无损,但所有更改都显示为changes to be committed 并带有git 状态(即签入以准备提交)。当你意识到你做了一些错误的提交时使用它,但工作都很好——你需要做的就是以不同的方式重新提交它。索引未受影响,因此您可以根据需要立即提交 - 生成的提交将具有与重置前相同的所有内容。
-
--merge 是最近添加的,旨在帮助您中止失败的合并。这是必要的,因为git merge 实际上会让您尝试与脏工作树(具有本地修改的工作树)合并,只要这些修改位于不受合并影响的文件中。 git reset --merge 重置索引(如 --mixed - 所有更改都显示为本地修改),并重置受合并影响的文件,但不理会其他文件。这有望将所有内容恢复到错误合并之前的状态。您通常会将其用作git reset --merge(意思是git reset --merge HEAD),因为您只想重置合并,而不是实际移动分支。 (HEAD还没有更新,因为合并失败了)
更具体地说,假设您修改了文件 A 和 B,并尝试在修改了文件 C 和 D 的分支中合并。由于某种原因合并失败,您决定中止它。你使用git reset --merge。它使 C 和 D 恢复到它们在 HEAD 中的状态,但将您的修改单独留给 A 和 B,因为它们不是尝试合并的一部分。
想了解更多?
我确实认为man git reset 确实非常适合这一点 - 也许您确实需要对 git 的工作方式有所了解才能真正融入其中。特别是,如果您花时间仔细阅读它们,那些详细说明所有各种选项和案例的索引和工作树中文件状态的表格非常有帮助。 (但是,是的,它们非常密集——它们以非常简洁的形式传达了上述大量信息。)
奇怪的符号
您提到的“奇怪符号”(HEAD^ 和 HEAD~1)只是指定提交的简写,而不必使用像 3ebe3f6 这样的哈希名称。它在 git-rev-parse 的手册页的 "specifying revisions" section 中有完整的记录,其中包含大量示例和相关语法。插入符号和波浪号实际上表示different things:
-
HEAD~ 是 HEAD~1 的缩写,表示提交的第一个父级。 HEAD~2 表示提交的第一个父级的第一个父级。将HEAD~n 视为“HEAD 之前的 n 次提交”或“HEAD 的第 n 代祖先”。
-
HEAD^(或HEAD^1)也表示提交的第一个父级。 HEAD^2 表示提交的 second 父级。请记住,正常的合并提交有两个父级 - 第一个父级是合并到的提交,第二个父级是合并的提交。一般来说,合并实际上可以有任意多个父级(章鱼合并)。
-
^ 和~ 运算符可以串在一起,如HEAD~3^2,HEAD 的第三代祖先的第二个父代,HEAD^^2,@ 的第一个父代的第二个父代987654383@,甚至是HEAD^^^,相当于HEAD~3。