上一节说到 git 的分支管理,虽然每次提交代码变动都 commit,有利于存储代码版本,但是在
git log
是会显示出这些临时提交的日志,无法准确定位到需要的版本。此时我们需要用到git stash
来处理
1.定义
Stash the changes in a dirty working directory away
将更改存储在脏的工作目录中
git stash
适用于你想保存当前的更改,还原工作目录以匹配 HEAD 的提交的情况。执行 git stash
,可以保存当前工作目录和索引的状态,又可以回到干净的工作目录。
命令行
git stash -m <message>
// 等同于 git stash push
将本地修改保存到新的存储项,然后将其回滚到 HEAD(在工作树和索引中)。 < message >
部分是可选的,提供说明以及隐藏状态。
2.查看 stash 的记录
git stash list
stash@{0}: WIP on submit: 6ebd0e2... Update git-stash documentation
stash@{1}: On master: 9cc0589... Add git-stash
git stash list
可以列出 stash 命令隐藏的修改。如果你执行了多次 git stash
,可以用该命令来打印隐藏的记录。
list 的格式以 stash@{index}
的方式列出,其中 stash@{0}
是最新的记录。
git stash show
显示存储项中记录的更改,作为存储项与首次创建存储项时的提交之间的差异。
3.提取记录
(1)stash pop
git stash pop [--index] [-q|--quiet]
从隐藏列表中删除一个单独的隐藏状态,并将其应用于当前工作树状态的顶部,即执行 git stash push
的逆操作。
git stash pop 是与push相对的,pop是从git栈中恢复第一个记录。
工作目录必须与索引匹配。不过应用状态可能会因冲突而失败;在这种情况下,它不会从存储列表中删除,需要手动解决冲突,然后手动调用 git stash drop
。
(2)stash apply
apply 与 pop 相似,但是 apply 不会删除 list 中的记录。
需要删除记录的话,需要执行 git stash drop
来删除。比如把指定版本号为 stash@{1}
的工作记录取出来,并在list中删除改记录
命令行
git stash apply stash@{1}
// 取出记录
git stash drop stash@{1}
// 删除list中的记录
4.清空记录 stash clear
如果存储了大量的工作记录,且是无用的代码。不如简单粗暴的清空它。
git stash clear
删除所有隐藏记录,并且可能无法恢复。
结语
git stash
属于将变动存储在本地的工作记录中,可以暂存数据。处于暂存区的代码,不会影响切换分支和拉取新代码。非常适用于多人合作开发、多分支开发等场景。