git stash 是 Git 中一个非常有用的命令，它可以临时保存当前工作区的修改，让你可以切换到其他分支或者处理其他任务，而不需要提交这些还未完成的修改。

---

一、基本用法

1. 保存当前修改（包括暂存区和工作区的内容）

git stash

2. 查看保存了哪些 stash

git stash list

示例输出：

stash@{0}: WIP on main: 1234567 Fix bug
stash@{1}: WIP on feature-x: abcdef0 Add feature x

3. 恢复最近一次 stash 并删除它

git stash pop

4. 恢复某一个 stash 并删除它

git stash pop stash@{1}

5. 恢复某一个 stash 但保留它

git stash apply stash@{1}

6. 删除某一个 stash

git stash drop stash@{0}

7. 清除所有 stash

git stash clear

---

二、常见增强用法

1. 只 stash 暂存区和工作区中已修改的文件（不包括未追踪文件）

git stash -k   # 等价于 git stash --keep-index

2. 包括未追踪的文件一起 stash

git stash -u   # 等价于 git stash --include-untracked

3. 包括未追踪和忽略的文件一起 stash

git stash -a   # 等价于 git stash --all

4. 带描述信息

git stash save "WIP: 修复登录页面问题"

注意：Git 2.15 之后推荐使用 git stash push -m "message" 代替 save。

---

三、举个例子

假设你在 main 分支开发中临时要切换到 bugfix 分支修复紧急问题：

git stash           # 保存当前未提交的代码
git checkout bugfix # 切换分支
...                 # 修复并提交
git checkout main   # 回到原分支
git stash pop       # 恢复之前保存的代码

---