版本控制与协作 / 系统课时
暂存未完成的工作
暂存未完成的工作
学习目标
完成本课后,你将能够:
- 使用 stash 保存已跟踪和未跟踪修改
- 在切换任务前恢复干净工作区
- 为 stash 条目编写可识别说明
问题背景或应用场景
开发到一半时可能需要立即切换分支处理紧急问题。直接提交半成品会污染历史,直接丢弃又会损失进度。stash 可以把当前工作区和暂存区状态保存为临时条目,让工作区恢复干净。
核心原理
git stash push 会保存已跟踪文件的工作区与暂存区变化,并将工作区恢复到当前提交。默认不包含未跟踪文件;使用 -u 才会一并保存。忽略文件仍不会自动进入 stash,除非使用更强的选项,但这通常不适合日常操作。
stash 是当前仓库中的临时引用栈,不是团队共享机制,也不应长期替代提交。为条目添加说明可以避免多次切换任务后无法识别内容。
基础用法
执行前先查看 git status --short,然后使用 git stash push -u -m "wip: <说明>"。保存后确认工作区干净,并通过 git stash list 验证条目存在。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-stash-save-demo
mkdir git-stash-save-demo
cd git-stash-save-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "mode=stable
" > app.conf
git add app.conf
git commit -q -m "chore: add stable config"
printf "mode=draft
" > app.conf
printf "temporary notes
" > notes.txt
git stash push -q -u -m "wip: update mode"
printf "pending: "
git status --short | wc -l | tr -d ' '
printf "stash: "
git stash list --format='%gs'
printf "file: "
cat app.conf预期输出
text
pending: 0
stash: On main: wip: update mode
file: mode=stableTips
- 使用
-m写清任务与阶段。 - 包含未跟踪文件时显式使用
-u。 - 长期重要工作应转为正式分支和提交。
常见错误
1. 未跟踪文件没有被保存
- 错误表现:切换任务后新文件仍留在工作区。
- 产生原因:默认 stash 不包含未跟踪文件。
- 正确处理:使用
git stash push -u并再次检查状态。 - 修复结果:工作区完全恢复干净。
2. 把 stash 当永久备份
- 错误表现:清理 stash 后重要工作丢失。
- 产生原因:stash 设计为临时引用。
- 正确处理:重要内容尽快恢复并提交到分支。
- 修复结果:关键工作进入可追踪历史。
本课练习
1. 保存含未跟踪文件的工作
- 任务目标:练习
-u。 - 输入或初始条件:修改一个已跟踪文件并创建新文件。
- 实现要求:保存后检查工作区。
- 验收条件:两类修改都从工作区消失且 stash 存在。
2. 创建多个说明清晰的 stash
- 任务目标:练习条目管理。
- 输入或初始条件:连续准备两个不同任务。
- 实现要求:分别保存并添加不同说明。
- 验收条件:列表能够区分两个条目。
3. 验证忽略文件行为
- 任务目标:理解默认边界。
- 输入或初始条件:创建被
.gitignore匹配的文件。 - 实现要求:执行普通 stash 和
-u。 - 验收条件:能够说明忽略文件为何仍未保存。
按自己的节奏,确认真正理解。