版本控制与协作 / 系统课时
丢弃工作区中的修改
丢弃工作区中的修改
学习目标
完成本课后,你将能够:
- 识别尚未暂存的工作区修改
- 使用 restore 恢复文件到暂存区版本
- 理解丢弃操作的数据风险
问题背景或应用场景
编辑文件后发现方向错误,最直接的处理是把工作区恢复到已暂存或已提交状态。但未提交内容没有进入 Git 对象历史,丢弃后通常无法通过普通 Git 命令找回,因此必须先确认修改是否真的不再需要。
核心原理
默认执行 git restore <文件> 时,Git 以暂存区为来源覆盖工作区文件。如果该文件没有额外暂存内容,暂存区通常与 HEAD 相同,所以效果看起来像恢复到最近提交。命令只作用于指定路径,不会移动分支,也不会创建提交。
未跟踪文件不受该命令影响;删除未跟踪文件需要其他工具。对重要修改更稳妥的做法是先创建临时提交、复制补丁,或使用 stash 保存,再执行恢复。
基础用法
先用 git diff -- <文件> 检查将被丢弃的内容,再执行 git restore <文件>。恢复后用 git status --short 和文件内容验证结果。不要在不理解路径范围时执行对整个目录的恢复。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-discard-worktree-demo
mkdir git-discard-worktree-demo
cd git-discard-worktree-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 "before: "
cat app.conf
git restore app.conf
printf "after: "
cat app.conf
printf "pending: "
git status --short | wc -l | tr -d ' '预期输出
text
before: mode=draft
after: mode=stable
pending: 0Tips
- 丢弃前先运行
git diff,确认没有需要保留的片段。 - 只恢复明确文件,不要习惯性对整个仓库执行恢复。
- IDE 的本地历史可能提供额外保障,但不能替代 Git 提交。
常见错误
1. 恢复错文件
- 错误表现:重要修改被覆盖。
- 产生原因:路径输入错误或使用了过大的路径范围。
- 正确处理:恢复前执行
git status --short与git diff -- <路径>。 - 修复结果:只处理目标文件,其他修改保持不变。
2. 认为可以恢复未跟踪文件
- 错误表现:删除未跟踪文件后尝试使用 Git 找回。
- 产生原因:未跟踪文件从未进入 Git 对象库。
- 正确处理:重要新文件先
git add、提交或单独备份。 - 修复结果:需要保留的内容进入可恢复状态。
本课练习
1. 恢复单个文件
- 任务目标:练习精确路径恢复。
- 输入或初始条件:同时修改两个已跟踪文件。
- 实现要求:只恢复其中一个。
- 验收条件:另一个文件仍保持修改状态。
2. 比较暂存前后来源
- 任务目标:理解 restore 默认来源。
- 输入或初始条件:修改并暂存文件后再次修改。
- 实现要求:执行恢复并观察工作区内容。
- 验收条件:文件恢复到暂存区版本而非更早版本。
3. 保存补丁再恢复
- 任务目标:建立安全操作习惯。
- 输入或初始条件:存在一组可能有用的修改。
- 实现要求:先导出 diff,再恢复文件。
- 验收条件:补丁文件包含被丢弃的变化。
按自己的节奏,确认真正理解。