深入理解 Git Stash：功能、用法与实战示例

深入理解 Git Stash：功能、用法与实战示例

git stash 是 Git 中用于临时保存当前工作区修改的命令，主要用于在切换分支或进行其他 Git 操作时，避免未提交的修改被干扰或丢失。Stash 允许你保存当前的修改，并在需要时重新应用。

一、Git Stash 的核心概念

Git Stash 类似于一个栈（Stack），使用 LIFO（后进先出） 方式管理多个存储项。每次执行 git stash，都会创建一个新的 stash 记录，并将其存入栈顶。

二、Git Stash 的基本用法

1. 存储当前修改

git stash

该命令会保存未提交的修改，但不会包括未追踪（untracked）的文件或被忽略的文件。

2. 查看 Stash 列表

git stash list

显示所有存储的 stash 记录，每个记录会有一个索引，如：

stash@{0}: WIP on main: 3a2e1b0 Add new feature
stash@{1}: WIP on develop: 8b51c14 Fix bug

3. 恢复 Stash

git stash apply

将最近的 stash 应用回当前工作区，但不会删除 stash 记录。

如果想应用某个特定的 stash（如 stash@{1}），可以使用：

git stash apply stash@{1}

4. 恢复并删除 Stash

git stash pop

该命令会恢复最近的 stash，并从 stash 栈中删除该记录。

5. 删除 Stash

（1）删除指定 Stash

git stash drop stash@{0}

删除指定的 stash 记录，如 stash@{0}。

（2）清空所有 Stash

git stash clear

删除所有 stash 记录，不可恢复！

---

三、Git Stash 进阶用法

1. 存储未追踪（untracked）文件

git stash -u

或

git stash --include-untracked

该命令会保存未追踪文件（untracked），但不包括被 .gitignore 忽略的文件。

2. 存储所有（包括被忽略的文件）

git stash -a

或

git stash --all

该命令会保存所有文件，包括 .gitignore 忽略的文件。

3. 为 Stash 添加描述

git stash save "修复首页样式问题"

这样在 git stash list 中可以看到有意义的描述。

4. 创建并切换到新分支

git stash branch new-feature-branch

该命令会：

• 创建一个新的 new-feature-branch 分支
• 切换到该分支
• 应用最近的 stash

---

四、Git Stash 示例

场景 1：切换分支但不想提交

假设你在 main 分支上做了一些修改，但暂时不想提交，需要切换到 develop 分支

# 查看当前状态
git status

# 临时保存工作
git stash

# 切换分支
git checkout develop

# 进行其他操作...

# 切回 main 分支
git checkout main

# 取回之前的修改
git stash pop

---

场景 2：修复 Bug 并恢复工作

假设你正在 feature-branch 分支开发一个新功能，但突然需要切换到 main 分支修复一个紧急 Bug

# 先 stash 你的当前工作
git stash

# 切换到 main 分支
git checkout main

# 修复 bug 并提交
git commit -am "Fix critical bug"

# 切回原来的分支
git checkout feature-branch

# 恢复之前的修改
git stash pop

---

场景 3：恢复特定 Stash

假设你有多个 stash 记录，并希望恢复某个特定的 stash

git stash list

输出：

stash@{0}: WIP on main: 修复登录界面样式
stash@{1}: WIP on main: 添加新功能
stash@{2}: WIP on develop: 调整 API 请求

如果你想恢复 stash@{1}，可以：

git stash apply stash@{1}

如果不再需要该 stash，可以手动删除：

git stash drop stash@{1}

---

五、总结

命令	作用
git stash	存储当前修改（不包含 untracked 文件）
git stash -u	存储当前修改（包含 untracked 文件）
git stash -a	存储当前修改（包含 untracked 和 ignored 文件）
git stash list	查看 stash 列表
git stash apply	恢复最近的 stash（不删除）
git stash pop	恢复最近的 stash（并删除）
git stash drop stash@{N}	删除指定 stash
git stash clear	清空所有 stash
git stash save "message"	带描述存储 stash
git stash branch new-branch	创建新分支并应用 stash

Git Stash 是一个非常实用的工具，能帮助你临时保存修改，避免代码丢失，灵活管理未提交的更改。