git stash 命令的用法

￡神魔★判官ぃ 2022-05-24 02:55 339阅读 0赞

## 简介 ##

默认情况下， 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）