8. 扩展¶

备注

较少用但是比较实用的技术。

8.1. git stash 1 ¶

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

发现有一个类是多余的，想删掉它又担心以后需要查看它的代码，想保存它但又不想增加一个脏的提交。这时就可以考虑 git stash。
使用 git 的时候，我们往往使用分支（branch）解决任务切换问题，例如，我们往往会建一个自己的分支去修改和调试代码, 如果别人或者自己发现原有的分支上有个不得不修改的 bug ，我们往往会把完成一半的代码 commit 提交到本地仓库，然后切换分支去修改 bug ，改好之后再切换回来。这样的话往往 log 上会有大量不必要的记录。其实如果我们不想提交完成一半或者不完善的代码，但是却不得不去修改一个紧急 Bug ，那么使用 git stash 就可以将你当前未提交到本地（和服务器）的代码推入到 Git 的栈中，这时候你的工作区间和上一次提交的内容是完全一样的，所以你可以放心的修 Bug ，等到修完 Bug ，提交到服务器上后，再使用 git stash apply 将以前一半的工作应用回来。
经常有这样的事情发生，当你正在进行项目中某一部分的工作，里面的东西处于一个比较杂乱的状态，而你想转到其他分支上进行一些工作。问题是，你不想提交进行了一半的工作，否则以后你无法回到这个工作点。解决这个问题的办法就是 git stash 命令。储藏(stash)可以获取你工作目录的中间状态——也就是你修改过的被追踪的文件和暂存的变更——并将它保存到一个未完结变更的堆栈中，随时可以重新应用。

当要记录工作目录和索引的当前状态，但想要返回到干净的工作目录时，则使用 git stash 。该命令保存本地修改，并恢复工作目录以匹配 HEAD 提交。

这个命令所储藏的修改可以使用 git stash list 列出，使用 git stash show 进行检查，并使用 git stash apply 恢复(可能在不同的提交之上)。默认情况下，储藏列表为“分支名称上的WIP”，但您可以在创建一个消息时在命令行上给出更具描述性的消息。如果你想应用更早的储藏，可以通过名字指定它，像这样： git stash apply stash@{2} 。如果不指明，Git 默认使用最近的储藏并尝试应用它。

git stash : 保存本地修改，并恢复工作目录以匹配HEAD提交。将会把存储放在存储队列的队头中。
git stash -m "message" : 默认情况下，储藏列表为 “WIP on 分支名: <default message>” ，但你可以在创建一个消息时在命令行上添加选项参数 -m 来给出更具描述性的消息。将会把存储放在存储队列的队头中。
git stash save : 调用没有任何参数的 git stash 相当于 git stash save 。将会把存储放在存储队列的队头中。
git stash show [stash-name] : 存储内容与创建此存储项时的提交状态之间的差异。
git stash list : 展示当前存储库中的存储队列。每个元素包含的信息有索引位置,存储时所在的分支,存储前的提交的描述。
git stash apply <stash-name> : 如果你想应用更早的储藏，可以通过名字指定它，像这样： git stash apply stash@{2}
git stash pop : 使用最近的储藏（即stash@{0}）并删除它
git stash drop <stash-name> : 删除指定存储的命令。
git stash clear : 删除所有缓存的stash。

注意

需要注意的是，git stash show 显示的是创建此存储项时的提交状态之间的差异，也就是说这个 git stash show 显示的值是不会变的。同时如果有注意到的话我们可以发现 git stash list 可以出现不同分支中的存储(如下 代码块 git stash list)，这说明本地仓库中的所有分支共用一个脏存储队列。

创建的最新储藏存储在 .git 目录下的 refs/stash 中。

代码块 8.1.1 git stash list¶

$ git stash list
stash@{0}: On b-doc: add a file named doc-file.md
stash@{1}: On main: save the main-file-1.md
stash@{2}: WIP on main: 4a5fae0 add fest

8.1.1. 实例1¶

当你处于某种状态的时候，你会发现有一些上游的变化可能与正在做的事情有关。当您的本地更改不会与上游的更改冲突时，简单的 git pull 将让您向前。但是，有些情况下，本地更改与上游更改相冲突， git pull 拒绝覆盖您的更改。在这种情况下，您可以将更改隐藏起来，执行 git pull ，然后重新获取本地更改解决冲突，如下所示：

git pull
...
file foobar not up to date, cannot merge.
$ git stash
$ git pull
$ git stash pop

8.1.2. 实例2¶

当你处于某种状态的时候，比如你的老板进来，要求立即开会或处理非常紧急的事务。传统上，应该提交一个临时分支来存储您的更改，并返回到原始(original)分支进行紧急修复，如下所示:

# ... 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 ...

8.2. 从其他分支中获取文件¶

待处理

应当添加到 git checkout 的详解篇章中

代码块 8.2.1 从其他分支中获取文件¶

git checkout source_branch <paths>

此命令会从目标分支中获取指定文件，并添加或覆盖到当前分支中。一般来说，路径以项目的根目录为起始。

1: 原文出自【易百教程】，原文链接：https://www.yiibai.com/git/git_stash.html