git-reset的作用是重置当前分支的HEAD指针,将HEAD指针指向特定的状态。

使用概述

git reset [<tree-ish>] [--] <pathspec>git reset [--pathspec-from-file=<file> [--pathspec-file-nul]] [<tree-ish>]git reset (--patch | -p) [<tree-ish>] [--] [<pathspec>]git reset [--soft | --mixed [-N] | --hard | --merge | --keep] [<commit>]

前三行reset命令的作用是将指定的<tree-ish>内容作为参考依据,然后把内容拷贝到目标的缓存区中。


(相关资料图)

最后一行reset命令的作用是将当前分支的HEAD指针指向<commit>,同时可以使用多种可选项来控制是否修改缓存区或工作区。

在以上所有的命令形式中,都是把<tree-ish>或<commit>默认作为HEAD指针。

git reset [<tree-ish>] [--] <pathspec>

该方法有如下规则:

会将与<pathspec>相匹配的路径资源在缓存区中重置成<tree-ish>中的状态。不了解<pathspec>是什么?

被提交到缓存区中的改动会被还原到工作区中。

举个?

假设项目中有一个coffee.txt文件,文件内容如下:

卡布奇诺纳瑞冰-19.9¥标准美式-14.9¥香草拿铁-19.9¥生椰爱摩卡-19.9¥...

我们使用git的tag命令将当前的版本标记成v1.0.0(这里使用tag标签作为)。

随后修改coffee.txt文件,修改内容如下:

卡布奇诺纳瑞冰-19.9¥ --> 卡布奇诺纳瑞冰-14.9¥标准美式-14.9¥ --> 标准美式-9.9¥香草拿铁-19.9¥ --> 香草拿铁-14.9¥生椰爱摩卡-19.9¥ --> 生椰爱摩卡-14.9¥...

变更了coffee.txt文件后,再使用git tag打上了v1.0.1标记。

如果此时想将coffee.txt文件还原成v1.0.0版本中的文件,就可以使用git reset命令并指定为v1.0.0,操作如下:

git reset v1.0.0 coffee.txt

使用VSCode查看缓存区的文件变动:

可以看到图中的右侧的代码改动对比,此时缓存区中的coffee.txt文件已经成功被重置成v1.0.0版本中文件的状态(规则1)。并且此时v1.0.1已经提交到缓存区中的变动也被还原到了工作树中(规则2)。

可以看出git reset命令与git add命令作用相反,一个是将指定的资源添加到缓存区,另一个则是从缓存区中移除。并且这个命令与git restore [--source=<tree-ish>] --staged <pathspec>具有相同的作用,对restore感兴趣的可以看看这篇文章。

上面说过了,在使用reset命令后,此时缓存区中文件内容是v1.0.0的,可以配合git restore命令将缓存区中的内容还原到工作区中然后进行修改:

git restore coffee.txt --staged

也可以根据需要选择还原工作区的内容:

git restore coffee.txt --worktree

git reset [--pathspec-from-file=<file> [--pathspec-file-nul]] [<tree-ish>]

在上面的例子中每次进行reset和restore的都是想同的<pathspec>路径(coffee.txt)。因为该文件路径比较简单,所以每次操作都比较方便输入。但是在一些情况下,可能需要reset比较复杂的<pathspec>路径,比如项目目录层次较深,那么很可能需要输入一长串的<pathspec>路径,这样每次进行操作就会很麻烦,所以git提供了一个--pathspec-from-file选项,让我们能够直接指定一个文件,这个文件就包含了可能需要重复使用的<pathspec>路径。这里有更详细的用法。

该文件每一行都是一个<pathspec>,如果有多个<pathspec>使用换行符作为分隔。当然也可以使用--pathspec-file-nul让NUL作为每一个<pathspec>的分隔符。

git reset (--patch | -p) [<tree-ish>] [--] [<pathspec>]

交互式的选择<tree-ish>与缓存区之间的差异而产生的hunks。这些被选择的hunks将会撤销缓存区中的产生的修改。这里有更详细的--patch选项用法。

git reset [<mode>] [<commit>]

该命令会把当前分支的HEAD指针指向某个<commit>,然后由<mode>决定是否同时更新缓存区或工作区的内容。<mode>默认值是--mixed,且必须是以下几种:

--soft

工作区和缓存区中的文件变动都将被保留,然后将HEAD指针指向<commit>。

还是以咖啡菜单为?,假如第一次commit到仓库中的文件内容如下:

卡布奇诺纳瑞冰-19.9¥标准美式-14.9¥香草拿铁-19.9¥生椰爱摩卡-19.9¥...

然后做第二次commit操作,删除标准美式,增加生椰拿铁:

卡布奇诺纳瑞冰-19.9¥-标准美式-14.9¥+生椰拿铁-19.9¥香草拿铁-19.9¥生椰爱摩卡-19.9¥...

在commit后,修改卡布奇诺纳瑞冰的价格,添加到缓存区。再修改香草拿铁的价格,保留在工作区:

-卡布奇诺纳瑞冰-19.9¥+卡布奇诺纳瑞冰-14.9¥ // 添加到缓存区中生椰拿铁-19.9¥-香草拿铁-19.9¥+香草拿铁-14.9¥ // 保留在工作区生椰爱摩卡-19.9¥...

此时我想保留工作区和缓存区做的改动,并且将HEAD指针指向第一次commit。这时可以使用--soft选项实现:

git reset HEAD^ --soft // 这里使用HEAD^表示上一个commit,同样也可以使用hash id

使用git log查看当前HEAD指针确实已经指向第一个commit,第二个commit被抛弃了:

同时所有的工作区和缓存区的改动都被保留了:

当前只有两次的commit,是为了方便演示--soft选项的作用。但是在实际开发中,我们可能会commit多次,尤其是在测试环境改几个BUG就要提交到发布平台,这样会导致很多无意义的commit。这时候就可以使用--soft选项,重置HEAD到指定的<commit>只保留一到两个重要的commit。

--mixed

重置缓存区,但是会保留工作区的内容,这是<mode>的默认值。

相信在理解了--soft作用后,理解--mixed不难,上面例子中如果是使用--mixed那么最终结果如下:

该选项会重置缓存区,但是保留工作区的改动,并将当前指针指向<commit>。

--hard

重置缓存区和工作区中的所有的变动,并且将指针指向<commit>。

--hard更加的简单粗暴,我们将--soft例子改为--hard来查看结果:

如图所示,工作区和缓存区的内容都被重置了。不止是如此,就连Untracked文件同样也会被删除。

--merge

该选项的作用,看字面意思就知道大概就是把当前分支和指定的<commit>进行合并,规则如下:

重置缓存区,任何已经添加到缓存区的改动都将被抛弃

如果<commit>和HEAD之间有文件存在不同(这个不同指的是文件被删除或者新增),那么将会把该文件重置成<commit>中的状态(新增或删除)。

如果<commit>和HEAD之间有文件存在不同(这个不同是指文件内容的不同),且此时工作区也存在未提交的改动,那么本次的reset将会被终止。

如果一个文件在<commit>和HEAD中完全相同,但是它的工作区存与缓存区存在着不同(也就是改动未提交到缓存区),那么该文件在工作区的改动在重置之后就会被保留。

我们举个例子来验证一下以上列出的规则,假设此时的咖啡店项目有如下的几个commit。

第一个commit和文件内容如下:

第一个commit中只有一个coffee.txt菜单文件,此时如果咖啡店引进了新品种开始卖果汁,那么就需要新增果汁菜单文件fruits.txt,于是就有了第二个commit:

此时我们做一些改动来验证1,2,4这几点的规则,改动后的文件如下:

首先修改coffee.txt文件,新增一款生椰拿铁咖啡,保留在工作区中。然后增加咖啡豆菜单文件beans.txt,将其添加到缓存区中。

假设因需求变动,咖啡豆菜单文件在缓存区中需要清除,果汁菜单文件需要删除,只有咖啡菜单中新增的生椰拿铁的改动需要保留。那么就可以使用git reset --merge将HEAD和commit-1进行合并,操作如下:

git reset --merge HEAD^

结果如下:

执行命令reset命令产生了如下效果:

将当前HEAD指针指向了commit-1将缓存区中的beans.txt文件抛弃(规则1)HEAD(commit-2)和commit-1中的fruits.txt文件存在不同(commit-2中新增fruits.txt),所以会将fruits.txt删除(规则2)coffee.txt文件新增生椰拿铁的改动被保留在工作区中(规则4)

再来验证一下第3点规则,假设咖啡店项目此时第一个commit如下:

接下去同样新增水果茶菜单,然后再修改coffee.txt文件,第二个commit如下:

然后在HEAD中再修改coffee.txt文件,删除掉标准美式品种:

此时,如果我们再使用git reset --merge HEAD^就无法再进行重置,该操作会被git终止(规则3)。并且控制台会进行报错提示:

--keep

该选参的作用和--merge相似,唯一的区别就是缓存区中被重置的会被保留在工作区中。

构造如下第一个commit:

改造第二个commit:

在HEAD中进行修改

使用git reset --keep命令:

从结果上来看,只有fruits.txt文件被删除了,beans.txt文件被重置回了工作区中。coffee.txt文件的改动也被保留了。

--[no-]recurse-submodules

使用该选项可以控制是否递归的重置submdoule。如果想要更详细了解,查看这篇文章。

总结

git-reset命令的作用就是重置缓存区和工作区,同时它也提供多个选项来做更具体的控制,使得该命令更加灵活多变。git-reset命令在我们的工作中经常使用,因此熟练掌握该命令是非常重要的。

更多编程相关知识,请访问:编程入门!!

以上就是Git命令学习之git-reset详解的详细内容,更多请关注php中文网其它相关文章!

推荐内容