什么是 git stash，你何时使用它？

Question

Accepted Answer

**git stash** 临时**保存你的未提交更改**并将你的工作目录恢复为干净状态——这样你可以切换上下文（例如在另一个分支上修复紧急 bug），而无需提交未完成的工作，然后稍后恢复这些更改。

## 为什么这很重要

```text
You're mid-work with uncommitted changes, but need to switch context urgently:
  → switch branches? Git may refuse (uncommitted changes would conflict) or carry
    them along messily
  → commit half-done work? No — it's not ready (pollutes history)
→ STASH saves your changes aside, giving you a clean working directory to switch.
```

## 使用 stash

```bash
git stash                      # save uncommitted changes; working dir becomes clean
git stash push -m "message"    # stash with a description
git stash list                 # list stashes (stash@{0}, stash@{1}, ...)

git stash pop                  # RESTORE the latest stash AND remove it from the list
git stash apply                # restore but KEEP it in the stash list
git stash apply stash@{1}      # apply a specific stash
git stash drop stash@{0}       # delete a stash
git stash clear                # remove all stashes
```

`git stash` 保存更改并清理工作目录；`git stash pop` 稍后恢复它们（并删除 stash）。`apply` 恢复而不删除。

## 常见场景

```bash
# working on a feature, but an urgent bug needs fixing on main:
git stash                      # save the in-progress feature work
git switch main
# ... fix the urgent bug, commit, push ...
git switch feature
git stash pop                  # restore the feature work and continue
```

## 有用的选项

```text
git stash -u        → also stash UNTRACKED files (not just tracked changes)
git stash show -p   → see what's in a stash
→ Stash is for TEMPORARY storage — not a substitute for commits/branches long-term.
```

## 为什么这很重要

理解 `git stash` 对于**干净地处理上下文切换**很有价值，这是一个常见的现实场景，因此它是有用的实用 Git 知识。

它解决的问题很频繁：你正在进行工作且有未提交的更改，此时你需要**紧急切换上下文**（在另一个分支上修复生产 bug、审查他人代码、拉取更新）——但带着未提交的更改切换分支是有问题的（Git 可能会拒绝或让它们混乱地跟随），而提交未完成的工作会污染历史记录。**Stash** 优雅地解决了这个问题，通过**将你的更改保存到一边**并为你提供一个干净的工作目录以切换上下文，然后**在你返回时恢复它们**——完全适合常见的"我需要暂时放下手中的工作"场景。

理解核心命令（`git stash` 保存、`git stash pop` 恢复并删除、`git stash apply` 恢复并保留、`git stash list` 查看 stash）和典型工作流（将进行中的工作 stash、切换并处理紧急任务、切换回来并 pop）是管理中断的实用日常知识。

了解有用的选项（`-u` 包含未追踪的文件、查看 stash 内容）以及 stash 用于**临时**存储（而非长期替代提交/分支）反映了正确的用法。

由于上下文切换和中断在开发中很常见（紧急 bug、代码审查、需要干净的工作目录），并且由于 stash 提供了一种干净、便捷的方式来临时搁置未提交的工作并稍后恢复它，理解 `git stash`——它解决什么、相关命令和常见的上下文切换工作流——对于处理频繁的现实需求（在不提交未完成工作的情况下切换上下文）来说是有价值的、实际相关的 Git 知识，是一个方便的工具，可以顺利处理日常开发中的常见中断。