怎么通过 Git 的 git stash 命令临时暂存当前未提交的本地代码修改

在 Git 版本控制的实际开发中，我们经常会遇到这样的情况：当前正在某个分支上修改代码，修改进行到一半还没有达到可以提交的标准，这时候突然需要切换到其他分支修复紧急问题，或者拉取远程最新代码。如果直接切换分支，Git 会提示工作区有未提交的修改，无法完成切换。这时候 git stash 命令就能派上用场，它可以将当前工作区和暂存区中未提交的修改临时保存起来，让工作区恢复到上一次提交后的干净状态，方便我们进行其他操作。

git stash 基本用法

暂存当前修改

最直接的暂存操作就是执行不带任何参数的 git stash 命令，它会将工作区和暂存区的所有未提交修改保存到 stash 栈中，同时将工作区恢复到 HEAD 指向的提交状态。

# 暂存当前所有未提交的修改
git stash

# 暂存时添加备注信息，方便后续识别
git stash save "修复用户登录 bug 前的临时修改"

执行完暂存命令后，可以通过 git status 查看工作区状态，会发现工作区已经没有未提交的修改了。

查看暂存的修改列表

如果需要查看之前暂存的所有修改记录，可以使用 git stash list 命令，它会列出 stash 栈中的所有暂存项，每个暂存项都有一个唯一的标识，比如 stash@{0} 表示最近一次暂存的修改。

# 查看所有暂存的修改
git stash list

输出结果类似如下内容：

stash@{0}: On feature/login: 修复用户登录 bug 前的临时修改
stash@{1}: On feature/order: 订单模块开发临时暂存

恢复暂存的修改

当我们需要继续之前的工作时，可以将暂存的修改恢复到工作区，常用的恢复命令有两个：

• git stash pop：恢复最近一次暂存的修改，并且会将这次暂存从 stash 栈中删除。
• git stash apply：恢复指定暂存的修改，不会删除 stash 栈中的对应暂存项，默认恢复最近的一次暂存。

# 恢复最近一次暂存的修改并删除该暂存项
git stash pop

# 恢复指定的暂存项，比如恢复 stash@{1}
git stash apply stash@{1}

# 恢复最近一次暂存但不删除暂存项
git stash apply

删除暂存的修改

如果某些暂存的修改已经不需要了，可以将其从 stash 栈中删除，避免栈中积累过多无用的暂存项。

# 删除最近一次暂存的修改
git stash drop

# 删除指定的暂存项，比如删除 stash@{0}
git stash drop stash@{0}

# 清空所有暂存的修改
git stash clear

git stash 常用参数

git stash 还有一些实用的参数，可以满足不同的暂存需求：

# 暂存包括未跟踪文件在内的所有修改
git stash -u

# 暂存所有文件，包括被忽略的文件
git stash -a

实际使用示例

假设当前我们在 feature/user 分支上开发用户个人信息修改功能，修改了 src/user.js 和 src/user.css 两个文件，还没有开发完成，这时候需要紧急切换到 main 分支修复一个线上问题，操作流程如下：

# 1. 暂存当前未提交的修改
git stash save "用户模块开发临时暂存"

# 2. 切换到 main 分支
git checkout main

# 3. 修复线上问题，提交修改
git add .
git commit -m "修复线上用户数据查询异常问题"

# 4. 切换回 feature/user 分支
git checkout feature/user

# 5. 恢复之前暂存的修改
git stash pop

# 6. 继续之前的开发工作

注意事项

• git stash 只会暂存已经被 Git 跟踪的文件和通过参数指定的未跟踪文件，默认不会暂存新增的未被跟踪的文件，如果需要暂存这类文件要加 -u 参数。
• 恢复暂存修改时如果出现冲突，需要手动解决冲突，和合并分支时的冲突解决方式一致。
• stash 栈中的暂存项是和本地仓库绑定的，不会推送到远程仓库，所以其他开发者无法获取你本地的 stash 暂存内容。
• 如果暂存的修改已经没有用处，建议及时清理，避免 stash 栈过长影响查看效率。

git stash 是 Git 中非常实用的一个功能，合理使用可以灵活应对开发中各种临时的分支切换需求，避免未完成的修改影响其他操作，是每个开发者都应该掌握的基础 Git 技能。

git_stashgit代码暂存git 命令修改时间：2026-06-24 09:00:17