版本控制与协作 / 系统课时
取消已暂存的文件
取消已暂存的文件
学习目标
完成本课后,你将能够:
- 识别已暂存与未暂存状态的区别
- 将文件从暂存区移回工作区
- 确认取消暂存不会删除修改内容
问题背景或应用场景
一次 git add 可能把无关文件或尚未完成的内容加入暂存区。此时目标不是删除修改,而是撤销“准备提交”的选择,让文件继续保留在工作区中,便于重新拆分提交。
核心原理
git restore --staged <文件> 会把暂存区中的指定路径恢复到 HEAD,但不会覆盖工作区。状态会从“已暂存修改”变为“未暂存修改”。旧版教程常使用 git reset HEAD <文件>,现代 Git 更推荐 restore --staged 表达路径恢复意图。
取消暂存不会改变文件内容,也不会移动当前分支。若仓库还没有第一次提交,HEAD 不存在,命令行为与可用写法需要特别注意;初学练习最好在已有提交的仓库中进行。
基础用法
先通过 git diff --staged 查看暂存内容,再执行 git restore --staged <文件>。随后使用 git diff 确认修改仍保留在工作区,并重新选择需要提交的部分。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-unstage-demo
mkdir git-unstage-demo
cd git-unstage-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "version=1
" > app.txt
git add app.txt
git commit -q -m "feat: add app"
printf "version=2
" > app.txt
git add app.txt
printf "before: "
git status --short
git restore --staged app.txt
printf "after: "
git status --short
printf "content: "
cat app.txt预期输出
text
before: M app.txt
after: M app.txt
content: version=2Tips
- 状态短格式第一列表示暂存区,第二列表示工作区。
- 取消暂存后可使用
git add -p重新按片段选择。 - 提交前同时检查
git diff和git diff --staged。
常见错误
1. 把取消暂存写成恢复工作区
- 错误表现:文件修改直接消失。
- 产生原因:使用了
git restore <文件>,遗漏--staged。 - 正确处理:先确认目标是移动暂存状态还是丢弃文件内容。
- 修复结果:修改保留,只有暂存选择被撤销。
2. 取消暂存后以为没有修改
- 错误表现:只查看了暂存差异,误判工作区干净。
- 产生原因:修改已经转回工作区。
- 正确处理:执行
git status和git diff。 - 修复结果:能够继续编辑或重新暂存。
本课练习
1. 取消一个文件
- 任务目标:拆分多个暂存文件。
- 输入或初始条件:同时暂存
a.txt与b.txt。 - 实现要求:只取消
b.txt的暂存。 - 验收条件:状态显示
a.txt已暂存、b.txt未暂存。
2. 按片段重新暂存
- 任务目标:练习提交粒度。
- 输入或初始条件:一个文件包含两类修改。
- 实现要求:取消暂存后使用交互式暂存选择一类修改。
- 验收条件:暂存差异只包含目标片段。
3. 验证内容不变
- 任务目标:确认操作边界。
- 输入或初始条件:记录取消暂存前的文件校验值。
- 实现要求:操作后再次计算校验值。
- 验收条件:两次值一致。
按自己的节奏,确认真正理解。