前言

git是用来管理代码和工作流的强大工具,它以commit为单位,低成本开辟分支等优势备受青睐.
在实际开发中,我们常常遇到一些复杂的应用场景,不单单是pull,commit,push就能解决.下面我们通过引入git stash的使用,来讨论在复杂情况下git发挥的强大功能.

git stash 的作用

git stash用于想要保存当前的修改,但是想回到之前最后一次提交的干净的工作仓库时进行的操作.git stash将本地的修改保存起来,并且将当前代码切换到HEAD提交上.

通过git stash存储的修改列表,可以通过git stash list查看.git stash show用于校验,git stash apply用于重新存储.直接执行git stash等同于git stash save.

最新的存储保存在refs/stash中.老的存储可以通过相关的参数获得,例如stash@{0}获取最新的存储,stash@{1}获取次新.stash@{2.hour.ago}获取两小时之前的.存储可以直接通过索引的位置来获得stash@{n}.

git stash的概念理解

git stash的每个存储单元在工作仓库中是通过commit的形式由树结构展示的.它的根节点是HEAD所在的提交.以下图标来表示stash和branch的关系.

git stash 工作树

H是HEAD提交.I是存储单元的提交.W是工作树中的提交.

应用举例

通过几个实际的示例来了解一下git stash的强大.

开发到一半,同步远端代码

当你的开发进行到一半,但是代码还不想进行提交 ,然后需要同步去关联远端代码时.如果你本地的代码和远端代码没有冲突时,可以直接通过git pull解决.但是如果可能发生冲突怎么办.直接git pull会拒绝覆盖当前的修改.

遇到这种情况,需要先保存本地的代码,进行git pull,然后再pop出本地代码:

git stash
git pull
git stash pop

工作流被打断,需要先做别的需求

当开发进行到一半,老板过来跟你说"线上有个bug,你现在给我改好,不然扣你鸡腿".当然,你可以开一个新的分支,把当前代码提交过去,回头再merge,具体代码如下

繁琐的工作流示例
# ... hack hack hack ...
 git checkout -b my_wip
 git commit -a -m "WIP"
 git checkout master
 edit emergency fix
 git commit -a -m "Fix in a hurry"
 git checkout my_wip
 git reset --soft HEAD^
# ... continue hacking ...

我们可以通过git stash来简化这个流程

正确姿势
# ... hack hack hack ...
 git stash        //保存开发到一半的代码
 edit emergency fix
 git commit -a -m "Fix in a hurry"
 git stash pop   //将代码追加到最新的提交之后
# ... continue hacking ...

提交特定文件

如果对多个文件做了修改,但是只想提交几个文件,或者想先暂时保存几个修改,测试其他文件的执行结果.可以通过git stash save --keep-index来进行.

# ... hack hack hack ...
 git add --patch foo            //只将第一部分加入管理the index
 git stash save --keep-index   //将其余部分保存起来
 edit/build/test first part
 git commit -m 'First part'    //提交全部的git管理中的代码
 git stash pop                  //继续进行存储代码的工作
# ... repeat above five steps until one commit remains ...
 edit/build/test remaining parts
 git commit foo -m 'Remaining parts'

恢复被错误clear/drop的存储

如果因为失误对存储仓库进行了clear或者drop操作,在一般机制下是不能恢复的.但是可以通过以下指令来获取仍在仓库中的,但是已经不可获取的存储列表

git fsck --unreachable |
grep commit | cut -d\  -f3 |
xargs git log --merges --no-walk --grep=WIP

git stash 的具体用法

git stash通过在指令后添加其他的附件选项,实现复杂的定制化操作,下面我们来对具体用法进行讲解.

save, push

• save [-p|--patch] [-k|--[no-]keep-index] [-u|--include-untracked] [-a|--all] [-q|--quiet] [<message>]

• push [-p|--patch] [-k|--[no-]keep-index] [-u|--include-untracked] [-a|--all] [-q|--quiet] [-m|--message <message>] [--] [<pathspec>…​]

save和push命令都可以用于存储修改.并且将git的工作状态切回到HEAD也就是上一次合法提交上.后面的<message>是选填项.

如果给定具体的文件路径,git stash只会处理路径下的文件.其他的文件不会被存储

--keep-index(简写为-k)只会存储为加入git管理的文件

--include-untracked为追踪的文件也会被缓存,当前的工作空间会被恢复为完全清空的状态.如果不使用--include-untracked而是用--all,那么除了未加入管理的文件,被git忽略(ignore)的文件也会被缓存.

--patch命令可以让我们选择当前修改和HEAD提交diff部分.

list

list [<options>]展示当前存储库中的存储单元列表.每个元素包含的信息有索引位置,存储时所在的分支,存储前的提交的描述.举例

stash@{0}: WIP on submit: 6ebd0e2... Update git-stash documentation
stash@{1}: On master: 9cc0589... Add git-stash

show

show [<stash>]展示存储单元和最新提交的diff结果.如果没有给定<stash>参数时,会对比最新的存储单元.

pop

pop [--index] [-q|--quiet] [<stash>]移除单个存储单元.和git stash save的作用相反.