简介

默认情况下， git stash 命令会把以下修改存储到一个新的堆栈中。堆栈中的内容（stash）可以被所有分支访问。

• 暂存区中的修改
• 工作区中已经存在的文件的修改

也就是说，默认情况下，git stash 命令不会存储下列文件。

• 工作区中新增的文件（untracked files）
• 被版本库忽略的文件（.gitignore 中定义的）

如果你还想要存储 untracked files，可以使用 -u 选项。

git stash -u

如果你还想要存储 untracked files 和被版本库忽略的文件，可以使用 -a 选项。

git stash -a

但是，一般不推荐这么做，因为既然是被版本库忽略的文件，就没有必要再存储起来。除非你有非常特别的需求。

如果你想要在 git stash 时，添加一个 message 注解，可以使用 save 选项。

git stash save "备注信息"

执行 git stash 命令后，工作区就恢复到了上一次 git commit 时的状态。具体表现为：

• 暂存区中的修改看不见了。
• 工作区中已经存在的文件的修改也看不见了。
• 如果使用了 -u 选项，工作区中新添加的文件对于工作区也看不见了。

这样工作区就干净多了。使用 git diff 和 git diff --cached 也看不到工作区和暂存区中的修改了。因为它们都被存储到了一个堆栈中。

然后，我们就可以新建分支，切换到新的分支来处理其他的需求。

git stash 的常用命令

存储到堆栈

git stash save -u "备注信息"

查看堆栈中的 stash 列表

# 堆栈中可能会有多个 stash，通过 stash_id 进行区分
git stash list

查看 stash 的内容

git stash show

git stash show stash@{id}

git stash show -p

将堆栈中的 stash 应用到工作区

# 将堆栈中的指定 stash 应用到工作区（保留堆栈的内容）
git stash apply stash@{id} 

# 将堆栈中的最近一次 stash，应用到工作区（保留堆栈的内容）
git stash apply

# 等价于上面的一条命令
git stash apply stash@{0}

既然是堆栈，那么就遵循『先进后出』。也就是说，如果 git stash 了多次，最近一次存储会位于堆栈的顶部（stash_id 为 0），它会被优先读取。

如果你想在成功应用了堆栈的 stash 后，立即将其从堆栈中删除。可以使用 git stash pop 命令。

# 将堆栈中的最近一次 stash，应用到工作区（删除堆栈的内容）
git stash pop

删除堆栈中的 stash

# 删除指定的 stash
git stash drop stash@{id} 

# 删除最近一次的 stash
git stash drop

# 删除所有的 stash
git stash clear

实例分析

比如，你在本地版本库的 dev 分支，开发某个需求，但是你只完成了一半，你又不想把它 git commit 提交到版本库，也就是说工作区或者暂存区中有一些你并不想提交到版本库的代码。这时，你又接到了另外一个需求，急需进行开发。你就可以使用 git stash 来解决这个问题。

首先，将工作区和暂存区中的修改，存储到堆栈。

git stash save -u "需求 a 只完成了一半"

这样，工作区和暂存区就都干净了。可以使用下面的命令进行检测。

D:\phpStudy\WWW\private-demo (dev)
λ git diff

D:\phpStudy\WWW\private-demo (dev)
λ git diff --cached

查看堆栈中的 stash 列表。（由于我们只 git stash 存储了一次，故堆栈中只有一个 stash）

λ git stash list
stash@{0}: On dev: 需求 a 只完成了一半

查看 stash 的内容。

D:\phpStudy\WWW\private-demo (dev)
λ git stash show
 a.php  | 2 ++
 b.php | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

然后，就可以在当前的 dev 分支中，优先完成需求 b。

如果需求 b 已开发完成，就将其提交到版本库。

D:\phpStudy\WWW\private-demo (dev)
λ git add .

λ git commit -m "需求 b 已完成"

如果需求 b 需要优先上线，就推送到远程仓库。

# 保持 dev 分支有 master 分支的最新代码
git pull origin master

# 推送到远程的 dev 分支
git push origin dev

最后，我们将堆栈中的 stash 弹出，应用到当前的工作区。

git stash pop

继续完成需求 a 中未完成的工作。

如果需求 a 也完成了，也将其提交到版本库。

git add .
git commit -m "需求 a 已完成"

然后，将其推送到远程仓库的对应分支。

# 保持 dev 分支有 master 分支的最新代码
git pull origin master

# 推送到远程的 dev 分支
git push origin dev

最后，在远程仓库发起合并到 master 分支的请求，等待管理员审核即可。

说明： 实际开发过程中，经常会遇到多个需求交叉开发的情况。可以用 git stash 堆栈来解决这个问题。当然，如果你对 git stash 掌握不好，也可以创建多个分支来解决。