在团队协作或个人开发中，我们经常会遇到这样的场景：正在开发一个新功能（Feature A），但突然需要紧急修复一个线上Bug（Bug Fix）。此时，直接提交未完成的功能代码显然不合适，而放弃当前修改又可能导致工作丢失。Git Stash 命令正是为解决这类问题而设计的，它允许开发者临时保存当前的工作状态，并在需要时恢复。本文ZHANID工具网将详细讲解 Git Stash 的使用方法及常见场景示例。
一、Git Stash 的核心作用
Git Stash 的核心作用是临时保存工作目录和暂存区（Stage）的修改，使开发者能够切换到其他分支或执行其他操作，而无需提交不完整的代码。其典型应用场景包括：
紧急任务切换：正在开发新功能时，需紧急修复Bug或处理其他任务。
代码清理：在提交前，希望将工作目录恢复到干净状态（如执行
git pull前避免冲突）。多任务并行：在多个任务间快速切换，而无需频繁提交临时代码。
二、Git Stash 基础命令详解
1. 保存当前修改：git stash
命令：
git stash作用：保存工作目录和暂存区的所有修改（包括未跟踪的文件，需加参数）。
示例：
# 保存当前修改并切换到其他分支 git stash git checkout main
2. 保存时添加描述信息：git stash save "message"
命令：
git stash save "message"作用：为保存的修改添加描述信息，便于后续识别。
示例：
git stash save "WIP: Feature A - 正在开发登录模块"
3. 查看保存的修改列表：git stash list
命令：
git stash list作用：列出所有保存的修改，按时间倒序排列。
示例：
git stash list # 输出： # stash@{0}: WIP: Feature A - 正在开发登录模块 # stash@{1}: WIP: Bug Fix - 修复表单提交错误
4. 恢复保存的修改：git stash apply
命令：
git stash apply stash@{n}（n为索引号，默认恢复最新保存的修改）作用：将指定的修改恢复到工作目录，但保留 Stash 记录。
示例：
# 恢复最新保存的修改 git stash apply # 恢复指定 Stash 的修改 git stash apply stash@{1}
5. 恢复并删除保存的修改：git stash pop
命令：
git stash pop stash@{n}作用：将指定的修改恢复到工作目录，并立即删除该 Stash 记录。
示例：
# 恢复并删除最新保存的修改 git stash pop # 恢复并删除指定 Stash 的修改 git stash pop stash@{1}
6. 删除保存的修改：git stash drop
命令：
git stash drop stash@{n}作用：删除指定的 Stash 记录。
示例：
# 删除最新保存的修改 git stash drop # 删除指定 Stash 的修改 git stash drop stash@{1}
7. 清空所有保存的修改：git stash clear
命令：
git stash clear作用：删除所有 Stash 记录，谨慎使用！
示例：
git stash clear
三、Git Stash 高级用法
1. 保存未跟踪的文件：git stash -u
命令：
git stash -u（或--include-untracked）作用：保存工作目录、暂存区以及未跟踪的文件（如新创建的文件）。
示例：
git stash -u
2. 保存时忽略部分文件：.gitignore
作用：通过
.gitignore文件排除不需要保存的文件。示例：
# 在 .gitignore 中添加： # *.log # temp/ git stash -u # 保存时自动忽略 .gitignore 中定义的文件
3. 创建分支并恢复修改：git stash branch
命令：
git stash branch <branch-name> stash@{n}作用：基于指定的 Stash 记录创建一个新分支，并在该分支上恢复修改。
示例：
git stash branch feature-a stash@{0}
4. 查看 Stash 差异：git stash show
命令：
git stash show stash@{n}作用：查看指定 Stash 记录的修改内容。
示例：
git stash show stash@{0}
四、实际场景示例
场景 1：紧急修复 Bug
保存当前功能开发：
git stash save "WIP: Feature A - 登录模块开发中"
切换到主分支并拉取最新代码：
git checkout main git pull origin main
创建新分支并修复 Bug：
git checkout -b bugfix/login-error # 修复 Bug 并提交 git commit -am "Fix: 修复登录表单验证错误"
合并修复到主分支：
git checkout main git merge bugfix/login-error git push origin main
切换回功能分支并恢复修改：
git checkout feature/login git stash pop
场景 2：代码清理与恢复
保存所有修改（包括未跟踪文件）：
git stash -u
拉取远程最新代码：
git pull origin main
恢复修改并解决冲突：
git stash pop # 解决可能出现的冲突后提交 git commit -am "Merge: 合并远程修改并解决冲突"
五、常见问题与解决方案
1. Stash 冲突
现象：恢复 Stash 时提示冲突。
解决：
手动解决冲突文件。
标记冲突已解决：
git add <file>。提交结果：
git commit -m "Resolve stash conflict"。
2. 误删 Stash
现象：误执行
git stash clear或git stash drop。解决：
Git 本身不提供直接恢复已删除 Stash 的命令，但可通过以下方式尝试恢复：
查找 Git 引用日志：
git reflog。定位到删除 Stash 前的提交，重新创建分支。
3. Stash 列表过长
现象：
git stash list输出过多记录，难以管理。解决：
定期清理无用 Stash：
git stash drop stash@{n}或git stash clear。使用描述性名称保存 Stash，便于后续识别。
六、最佳实践建议
添加描述信息：始终为 Stash 添加有意义的描述（如
git stash save "message"），便于后续追踪。优先使用
pop：在确定不再需要某个 Stash 时，使用git stash pop恢复并自动删除。谨慎使用
clear：避免误删所有 Stash，执行前确保无重要修改。结合分支使用：对于长期未完成的任务，建议基于 Stash 创建新分支（
git stash branch），避免 Stash 列表堆积。
总结
Git Stash 是 Git 工具链中不可或缺的命令，它通过临时保存工作状态，极大提升了开发者在多任务切换和紧急情况下的效率。掌握 git stash、git stash apply、git stash pop 等核心命令，结合 .gitignore 和分支管理，可以更优雅地应对复杂的开发场景。合理使用 Stash，让代码管理更加从容！
本文由@战地网 原创发布。
该文章观点仅代表作者本人，不代表本站立场。本站不承担相关法律责任。
如若转载，请注明出处：https://www.zhanid.com/biancheng/4256.html
