时间	更新备注
2018-03-10	新建文章
2018-06-08	整理补充
2019-01-18	更新链接

引言

暂存未跟踪或忽略的文件
默认情况下，git stash会缓存下列文件：

• 添加到暂存区的修改（staged changes）
• Git跟踪的但并未添加到暂存区的修改（unstaged changes）

stash就是存储的意思，比如你在做一件事情的同时，突然又有了别的工作。就把现在的工作存储下来。并不提交到主线任务。而且可以顺利恢复上次的进度。

目录

• Git 笔记系列（一）—— Git简介
• Git 笔记系列（二）—— Git工作流程
• Git 笔记系列（三）—— Git常用命令-一览
• Git 笔记系列（四）—— Git常用命令-Checkout
• Git 笔记系列（五）—— Git常用命令-Branch
• Git 笔记系列（六）—— Git常用命令-Reset
• Git 笔记系列（七）—— Git常用命令-Rebase
• Git 笔记系列（八）—— Git常用命令-Stash等
• Git 笔记系列（九）—— Git进阶

Git-Stash

暂存未跟踪或忽略的文件
默认情况下，git stash会缓存下列文件：

• 添加到暂存区的修改（staged changes）
• Git跟踪的但并未添加到暂存区的修改（unstaged changes）

但不会缓存以下文件：

• 在工作目录中新的文件（untracked files）
• 被忽略的文件（ignored files）

git stash（git储藏）可用于以下情形：

• 使用git的时候，我们往往使用分支（branch）解决任务切换问题，例如，我们往往会建一个自己的分支去修改和调试代码, 如果别人或者自己发现原有的分支上有个不得不修改的bug，我们往往会把完成一半的代码commit提交到本地仓库，然后切换分支去修改bug，改好之后再切换回来。这样的话往往log上会有大量不必要的记录。其实如果我们不想提交完成一半或者不完善的代码，但是却不得不去修改一个紧急Bug，那么使用git stash就可以将你当前未提交到本地（和服务器）的代码推入到Git的栈中，这时候你的工作区间和上一次提交的内容是完全一样的，所以你可以放心的修Bug，等到修完Bug，提交到服务器上后，再使用git stash apply将以前一半的工作应用回来。

• 经常有这样的事情发生，当你正在进行项目中某一部分的工作，里面的东西处于一个比较杂乱的状态，而你想转到其他分支上进行一些工作。问题是，你不想提交进行了一半的工作，否则以后你无法回到这个工作点。解决这个问题的办法就是git stash命令。储藏(stash)可以获取你工作目录的中间状态——也就是你修改过的被追踪的文件和暂存的变更——并将它保存到一个未完结变更的堆栈中，随时可以重新应用。

git stash可以暂存本地的改动到stash stack中

#show the stash stack list
git stash show list

#show the second one in the stashes stash stack
git stash show stash@{1}

#show the diff of stash
git stash show -p

#可以通过git stash apply命令恢复之前缓存的工作目录，不会将其从堆栈中移走
git stash apply

#recover the stashed diff delete the top stash for stash stack
#git stash pop命令恢复之前缓存的工作目录，同时立刻将其从堆栈中移走
git stash pop

实际应用中推荐给每个stash加一个message，用于记录版本，使用git stash save取代git stash命令。示例如下：

$ git stash save "test-cmd-stash"
Saved working directory and index state On autoswitch: test-cmd-stash
HEAD 现在位于 296e8d4 remove unnecessary postion reset in onResume function
$ git stash list
stash@{0}: On autoswitch: test-cmd-stash