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

取消已暂存的文件

取消已暂存的文件

学习目标

完成本课后,你将能够:

  • 识别已暂存与未暂存状态的区别
  • 将文件从暂存区移回工作区
  • 确认取消暂存不会删除修改内容

问题背景或应用场景

一次 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=2

Tips

  • 状态短格式第一列表示暂存区,第二列表示工作区。
  • 取消暂存后可使用 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. 验证内容不变

  • 任务目标:确认操作边界。
  • 输入或初始条件:记录取消暂存前的文件校验值。
  • 实现要求:操作后再次计算校验值。
  • 验收条件:两次值一致。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

取消已暂存的文件

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

登录哪都通