版本控制与协作 / 系统课时
使用 restore 恢复指定文件
使用 restore 恢复指定文件
学习目标
完成本课后,你将能够:
- 掌握 restore 的工作区与暂存区模式
- 指定来源提交恢复文件内容
- 避免把路径恢复与分支切换混淆
问题背景或应用场景
git restore 把“恢复路径内容”从旧式 checkout 和部分 reset 用法中拆分出来,使命令意图更清晰。它既可恢复工作区,也可操作暂存区,还能从指定提交取出某个文件,而不切换整个分支。
核心原理
不带 --staged 时,目标是工作区;带 --staged 时,目标是暂存区。--source=<提交> 指定恢复来源,否则恢复工作区时默认来源为暂存区,恢复暂存区时默认来源为 HEAD。同时使用 --staged --worktree 会修改两个区域,风险更高。
恢复单个历史文件不会移动 HEAD,也不会把整个仓库切换到旧版本。文件恢复后只是新的未提交变化,仍需检查、暂存和提交才能进入历史。
基础用法
常见命令包括 git restore file、git restore --staged file 和 git restore --source=HEAD~1 file。使用历史来源前先执行 git show HEAD~1:file 预览内容。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-restore-source-demo
mkdir git-restore-source-demo
cd git-restore-source-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "alpha=v1
" > a.txt
printf "beta=v1
" > b.txt
git add a.txt b.txt
git commit -q -m "feat: version 1"
printf "alpha=v2
" > a.txt
printf "beta=v2
" > b.txt
git add a.txt b.txt
git commit -q -m "feat: version 2"
git restore --source=HEAD~1 a.txt
printf "a: "
cat a.txt
printf "b: "
cat b.txt
printf "status: "
git status --short预期输出
text
a: alpha=v1
b: beta=v2
status: M a.txtTips
- 恢复历史文件前先用
git show <提交>:<路径>预览。 - 路径中有特殊字符时使用
--分隔修订与路径。 - 同时修改暂存区和工作区前,先确认没有未保存内容。
常见错误
1. 把 source 当成目标分支
- 错误表现:执行后期待当前分支切换。
- 产生原因:
restore只恢复路径,不切换分支。 - 正确处理:需要切换分支时使用
git switch。 - 修复结果:分支操作和文件恢复意图明确分离。
2. 恢复后忘记提交
- 错误表现:文件已回到旧内容,但其他人看不到。
- 产生原因:恢复只产生本地工作区修改。
- 正确处理:检查差异后重新暂存并提交。
- 修复结果:恢复结果成为可共享提交。
本课练习
1. 恢复目录内文件
- 任务目标:练习路径范围。
- 输入或初始条件:一个目录中多个文件被修改。
- 实现要求:只恢复该目录,不影响其他目录。
- 验收条件:状态中仅保留目录外修改。
2. 从标签恢复文件
- 任务目标:使用命名引用作为来源。
- 输入或初始条件:仓库存在标签
v1.0.0。 - 实现要求:从标签恢复一个配置文件。
- 验收条件:文件内容与标签版本一致。
3. 同时恢复两个区域
- 任务目标:理解高风险选项。
- 输入或初始条件:文件既有暂存修改又有工作区修改。
- 实现要求:在备份后使用
--staged --worktree。 - 验收条件:两个区域均恢复到指定来源。
按自己的节奏,确认真正理解。