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

使用 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.txt

Tips

  • 恢复历史文件前先用 git show <提交>:<路径> 预览。
  • 路径中有特殊字符时使用 -- 分隔修订与路径。
  • 同时修改暂存区和工作区前,先确认没有未保存内容。

常见错误

1. 把 source 当成目标分支

  • 错误表现:执行后期待当前分支切换。
  • 产生原因:restore 只恢复路径,不切换分支。
  • 正确处理:需要切换分支时使用 git switch。
  • 修复结果:分支操作和文件恢复意图明确分离。

2. 恢复后忘记提交

  • 错误表现:文件已回到旧内容,但其他人看不到。
  • 产生原因:恢复只产生本地工作区修改。
  • 正确处理:检查差异后重新暂存并提交。
  • 修复结果:恢复结果成为可共享提交。

本课练习

1. 恢复目录内文件

  • 任务目标:练习路径范围。
  • 输入或初始条件:一个目录中多个文件被修改。
  • 实现要求:只恢复该目录,不影响其他目录。
  • 验收条件:状态中仅保留目录外修改。

2. 从标签恢复文件

  • 任务目标:使用命名引用作为来源。
  • 输入或初始条件:仓库存在标签 v1.0.0。
  • 实现要求:从标签恢复一个配置文件。
  • 验收条件:文件内容与标签版本一致。

3. 同时恢复两个区域

  • 任务目标:理解高风险选项。
  • 输入或初始条件:文件既有暂存修改又有工作区修改。
  • 实现要求:在备份后使用 --staged --worktree。
  • 验收条件:两个区域均恢复到指定来源。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 restore 恢复指定文件

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

登录哪都通