Git基础教程（十一）进阶操作之Stash：Git救火队长：Stash操作，让你在代码的惊涛骇浪中优雅“泊车”！

最新推荐文章于 2025-11-24 23:15:52 发布

原创最新推荐文章于 2025-11-24 23:15:52 发布 · 406 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#git

Git基础教程专栏收录该内容

15 篇文章

订阅专栏

引言：一场突如其来的“代码危机”

想象一下这个场景：你正沉浸在自己的feature-awesome分支里，手指在键盘上飞舞，重构的代码刚刚完成一半，逻辑链条在脑海中无比清晰。就在这时，企业微信“叮”了一声，你的主管@了你：“线上有个致命Bug，火速切到hotfix分支，15分钟内搞定！”

你心头一紧，眼前是尚未完成、甚至无法通过编译的一堆修改。怎么办？
选择A： 硬着头皮git checkout hotfix？Git会无情地阻止你：“你本地还有修改呢，请先提交或Stash！”
选择B： 草草git add .然后git commit -m "WIP: temp commit"？这会在你的提交历史上留下一个丑陋的、无意义的“污点”，像一块随意丢弃的垃圾。

有没有一种方法，既能清空工作区，又能完美保存当前的工作进度，就像游戏里的“存档点”一样，随时可以读档归来？

当然有！这就是本文的主角——git stash，你的代码“救火队长”、时空暂停器、多任务切换的终极神器！

第一章：Stash初窥——基础操作，你的紧急逃生舱

1.1 什么是Stash？

官方解释：Stash用于将您的工作目录和暂存区中的修改保存到一个脏工作区的堆栈中，以便您可以在一个干净的工作目录上处理其他事务。

说人话：它把你未提交的代码（无论是已add到暂存区的，还是未add的）打包成一个“包裹”，临时塞进仓库的一个秘密角落里，让你的工作区瞬间变干净。 之后你可以随时把这个“包裹”取出来，恢复之前的工作现场。

1.2 基础三连：存、看、取

让我们用示例来演示。假设你正在修改script.js文件。

# 1. 查看当前状态（一片狼藉）
$ git status
On branch feature-awesome
Changes not staged for commit:
  modified:   script.js

# 2. 执行“时空暂停”——存！
$ git stash
Saved working directory and index state WIP on feature-awesome: e6a5c0f Initial commit

# 3. 再次查看状态（豁然开朗）
$ git status
On branch feature-awesome
nothing to commit, working tree clean

看，世界清净了！现在你可以安心地切到hotfix分支去救火了。

救火完毕，你回到feature-awesome分支，准备恢复之前的工作。

# 切换回功能分支
$ git checkout feature-awesome

# 4. 查看现有的所有“存档”（Stash列表）
$ git stash list
stash@{0}: WIP on feature-awesome: e6a5c0f Initial commit

# 5. 恢复最新的那个“存档”——取！
$ git stash pop

pop命令会恢复最新的一次Stash（即stash@{0}），并同时将它从Stash堆栈中删除。就像从栈顶弹出一个元素。

如果你想恢复但不删除Stash记录，可以使用apply命令：

$ git stash apply
# 或者指定应用某一条记录
$ git stash apply stash@{1}

apply之后，stash list里的记录依然存在，你可以多次应用同一条记录到不同的分支（虽然通常不这么干）。

第二章：进阶秘籍——Stash的隐藏玩法与深度剖析

只会stash pop？那你才用了它1%的功力。下面才是真正的精华。

2.1 给“存档”写个备注（git stash save -m "message"）

默认的Stash消息是WIP on branch...，毫无信息量。当你多次Stash后，list一看会完全想不起里面是什么。

$ git stash save -m "重构了用户登录模块，半成品"
Saved working directory and index state On feature-awesome: 重构了用户登录模块，半成品

$ git stash list
stash@{0}: On feature-awesome: 重构了用户登录模块，半成品
stash@{1}: WIP on feature-awesome: e6a5c0f Initial commit

这样一目了然，妈妈再也不用我担心我恢复错存档了。

2.2 选择性“存档”——精雕细琢（git stash push -p）

这是超级大招！有时候你同时改了多个文件，但只想Stash其中一部分，另一部分想保留在工作区继续修改。-p（--patch）选项允许你交互式地选择每一个代码块（hunk）是否要放入Stash。

$ git stash push -p

执行后，Git会展示每一个改动片段，并询问你：

Stash this hunk [y,n,q,a,d,/,?]?

y：是的，暂存这个片段
n：不，不暂存
q：退出（已选择的会进行Stash）
a：暂存这个文件和后续所有片段
d：不暂存这个文件和后续所有片段
?：查看帮助

这让你能极其精细地控制存入Stash的内容，堪称代码管理的“微操”艺术。

2.3 为Stash创建新分支（git stash branch <branch_name>）

这是一个能拯救你于水火的命令。场景：你Stash了一些代码，然后过去了好久，你在当前分支又进行了很多新的提交。当你尝试pop或apply时，很可能出现冲突！因为Stash里的代码和现在分支的代码已经 diverged（分叉）了。

这时，git stash branch是完美的解决方案。它会基于当初创建Stash时的那个提交创建一个新分支，并自动将Stash内容pop到这个新分支上。

# 查看Stash记录，发现是很久以前存的
$ git stash list
stash@{0}: On feature-awesome: 我的古老修改

# 智能地创建新分支来恢复，完美避免冲突
$ git stash branch new-branch-for-ancient-stash

这样，你的古老修改就在一个独立、安全的新分支里重见天日了。

2.4 查看Stash里有什么（git stash show）

不确定某个Stash里藏了啥？可以用show命令查看diff摘要。

# 查看最新Stash的摘要
$ git stash show
 script.js | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

# 查看详情（类似git diff）
$ git stash show -p

2.5 清理Stash列表

就像清理浏览器历史记录一样，有时你需要清理无用的Stash。

# 删除指定的Stash
$ git stash drop stash@{1}

# 清空整个Stash列表（慎用！）
$ git stash clear

第三章：完整实战示例——一场行云流水的多任务协作

假设你是开发者Alice，任务是给网站添加“黑暗模式”（Dark Mode）。

步骤1：开始新功能

$ git checkout -b feature-dark-mode
# ...开始疯狂编码，修改了style.css和theme.js...

步骤2：紧急插队任务
正当你写到一半，需要测试一个函数时，线上报警——首页Logo显示错了！

# 1. 保存当前进度，并写好备注
$ git stash save -m "Dark Mode: 完成了核心配色函数和CSS变量定义"

# 2. 工作区干净了，切到主分支并创建热修复分支
$ git checkout main
$ git checkout -b hotfix-logo

# 3. 修复Logo问题，提交
# ...修改logo.png...
$ git add logo.png
$ git commit -m "fix: use correct logo asset"

# 4. 合并修复，并推送
$ git checkout main
$ git merge hotfix-logo
$ git push origin main
# 删除临时热修分支
$ git branch -d hotfix-logo

步骤3：回归主任务

# 1. 回到功能分支
$ git checkout feature-dark-mode

# 2. 查看存档列表，确认我们要恢复的存档
$ git stash list
stash@{0}: On feature-dark-mode: Dark Mode: 完成了核心配色函数和CSS变量定义

# 3. 恢复工作进度
$ git stash pop

完美！你的工作区又回到了之前的状态，可以继续专注地开发黑暗模式了。整个流程没有产生任何一次无用的提交，历史记录清晰整洁。