VSCode内置Git Stash功能支持暂存未提交修改，适用于紧急切分支、拉取更新、临时重构等场景；操作路径为源代码管理视图右上角菜单，可命名、选择文件、恢复、应用或删除stash，并需注意未跟踪文件、冲突处理及误删恢复。
VSCode 内置的 Git Stash 功能，让你不用切到终端就能暂存未提交的修改，特别适合临时切换分支、快速修复 bug 或清理工作区。关键是操作简单，但容易忽略细节，比如 stash 的命名、恢复时的冲突处理、或误删 stash 后怎么找回。
什么时候该用 Git Stash？
不是所有“先放一边”的修改都适合 stash。以下场景最常用：
- 正在改功能，但突然要切到 main 修一个紧急 hotfix：不提交又不能丢改动，stash 是最轻量的暂存方式
- 本地有大量未完成代码，想拉最新远程分支又怕 merge 冲突：先 stash，再 pull，再 pop，避免脏工作区干扰更新
- 尝试某种重构，不确定是否保留，又不想立刻提交（commit 会进历史）：stash 相当于“草稿箱”，随时可丢弃或重试
- 多人协作中，你本地改了配置文件（如 .env），但不该提交，又不想每次 git checkout 都被提醒覆盖：stash 掉它，切分支更干净
在 VSCode 里怎么 stash？
打开源代码管理视图（Ctrl+Shift+G / Cmd+Shift+G），左侧能看到当前变更列表。右上角有三个点（⋯）菜单，点击后选择 Stash Changes 即可。
默认 stash 不带消息，但建议养成加描述的习惯——VSCode 会在弹出输入框时提示你填（例如 “wip: user login UI tweaks”）。这样后续多个 stash 并存时，一眼能分清哪个是哪次暂存的。
如果你改了多个文件，但只想 stash 其中几个：先在变更列表里勾选目标文件，再点 ⋯ → Stash Selected Changes（VSCode 1.85+ 支持）。
如何恢复、查看和管理 stash？
stash 列表藏得有点深：点击源代码管理面板右上角 ⋯ → Stash List，就会弹出所有 stash（按时间倒序）。每个条目显示时间、分支名和你写的描述。
- 恢复（pop）：选中某条 stash，点右侧 ▶️ 图标 —— 它会把改动重新应用，并从 stash 列表删除
- 仅应用（apply）：右键 stash → Apply Stash，改动回来但 stash 保留在列表里，适合反复测试
- 删除某个 stash：右键 → Drop Stash；清空全部 → ⋯ → Drop All Stashes
- 从 stash 创建新分支：右键 → Create Branch from Stash，适合把临时想法转为正式开发分支
常见问题与避坑提醒
stash 看似简单，但几个细节不注意就容易踩坑：
- stash 默认不包含未跟踪文件（untracked）：如果改了新文件且没 git add，stash 后它们会消失！解决方法：stash 前勾选 “Include untracked files”，或在设置里搜 git.stashIncludeUntracked 开启全局默认
- pop 时发生冲突，VSCode 不会自动标记冲突块：它只是把改动硬塞进来，你需要自己打开冲突文件看 >> 标记，手动解决后 git add 再 commit
-
误删 stash？别慌：只要没执行
git gc，stash 对象还在 Git 对象库里。打开终端运行git reflog，找到类似stash@{0}的记录，再用git stash apply stash@{0}恢复 - stash 和 commit 的本质区别：stash 是临时快照，不参与分支历史；commit 是永久记录，带 author、message、parent。别用 stash 替代合理的小步提交
基本上就这些。用熟之后，stash 就像剪贴板一样自然——按需暂存、精准还原、不污染历史。不复杂，但容易忽略细节。
