版本控制与协作 / 系统课时

恢复和管理 stash

恢复和管理 stash

学习目标

完成本课后,你将能够:

  • 查看并选择 stash 条目
  • 区分 apply 与 pop 的行为
  • 安全删除已确认无用的 stash

问题背景或应用场景

stash 保存后还需要在正确分支和正确时机恢复。apply 与 pop 的差别决定条目是否保留;当恢复发生冲突时,条目管理也会影响是否还有回退线索。

核心原理

git stash apply 应用条目但保留它,适合先验证恢复结果;git stash pop 应用成功后删除条目,更适合确认环境匹配的情况。指定条目时使用 stash@{n},但序号会随新增和删除变化,操作前应重新查看列表。

恢复 stash 可能发生冲突,因为当前分支文件已经变化。发生冲突时应按普通冲突流程处理;不要在未确认内容前执行 clear,因为它会一次删除全部条目。

基础用法

先执行 git stash list,必要时用 git stash show -p stash@{0} 预览。第一次恢复推荐 apply;确认无误后用 drop 删除。需要一步完成时再使用 pop。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。

bash
rm -rf git-stash-manage-demo
mkdir git-stash-manage-demo
cd git-stash-manage-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "state=clean
" > app.conf
git add app.conf
git commit -q -m "chore: add config"
printf "state=draft
" > app.conf
git stash push -q -m "wip: draft state"
git stash apply -q
printf "after-apply: "
cat app.conf
printf "count-after-apply: "
git stash list | wc -l | tr -d ' '
git reset -q --hard HEAD
git stash pop -q
printf "after-pop: "
cat app.conf
printf "count-after-pop: "
git stash list | wc -l | tr -d ' '

预期输出

text
after-apply: state=draft
count-after-apply: 1
after-pop: state=draft
count-after-pop: 0

Tips

  • 恢复前使用 stash show -p 预览。
  • 不确定时先 apply,再手动 drop。
  • 多个 stash 存在时不要凭记忆使用序号。

常见错误

1. 误用 pop 导致条目消失

  • 错误表现:恢复后想再次使用同一条目却找不到。
  • 产生原因:pop 成功后会删除条目。
  • 正确处理:不确定时先使用 apply。
  • 修复结果:条目保留到确认不再需要。

2. clear 删除全部临时工作

  • 错误表现:多个 stash 一次消失。
  • 产生原因:把 clear 当成删除单个条目。
  • 正确处理:单个删除使用 drop stash@{n}。
  • 修复结果:只清理明确无用的目标条目。

本课练习

1. 恢复指定旧条目

  • 任务目标:练习 stash 选择。
  • 输入或初始条件:列表中有两个条目。
  • 实现要求:应用较旧条目而不删除。
  • 验收条件:工作区出现对应修改,列表数量不变。

2. 比较 apply 与 pop

  • 任务目标:验证条目生命周期。
  • 输入或初始条件:复制同一仓库两份。
  • 实现要求:分别执行 apply 和 pop。
  • 验收条件:能够比较列表数量。

3. 处理 stash 冲突

  • 任务目标:练习恢复冲突。
  • 输入或初始条件:保存修改后在当前分支改动同一行。
  • 实现要求:应用 stash 并解决冲突。
  • 验收条件:文件内容符合预期,仓库无未解决路径。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

恢复和管理 stash

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通