git restore

文章目录

1.简介

restore 是由 git 2.23 版本引入,是一个比较新的命令,用于恢复暂存区或者工作区中的文件。

恢复工作区中的文件,也可以使用git checkout -- <file>。可见,restore 实现了 checkout 的文件恢复功能,restore 更加符合恢复语义,建议使用。

2.格式

shell 复制代码
 git restore [<options>] [--source=<tree>] [--staged] [--worktree] [--] <pathspec>...​

--表示后面的参数均不是选项。

3.选项

复制代码
-W, --worktree
	恢复工作区指定文件,为缺省选项。
-S, --staged
	将暂存区指定文件回退到工作区。
-s, --source=<tree>
	指明要恢复的文件内容所在的 commit,branch 或 tag,缺省为 HEAD。
<pathspec>...​
	 限制受操作影响的路径。可以是文件,也可以是目录。
-p, --patch
	交互式选择恢复内容(块级恢复)。

4.示例

  • 撤销工作区修改(未 add 的文件)。
shell 复制代码
# 恢复指定文件
git restore <file>...

# 恢复所有修改(谨慎使用)
git restore .
  • 撤销暂存区修改(已 add 的文件)。

将暂存区的文件回退到工作区,保留工作区修改。

shell 复制代码
# 撤销指定文件
git restore --staged <file>...

# 撤销所有文件
git restore --staged .
  • 将工作区和暂存区中的所有文件还原到最新的提交状态。
shell 复制代码
git restore --staged --worktree .

# 或者
git restore -SW .

5.注意事项

  • 不可逆操作

恢复操作会永久丢弃未提交的修改,无法通过 Git 找回(IDE 可能有本地历史记录)。

  • 新文件处理

git restore 无法恢复未跟踪的新文件,需手动删除或使用:

shell 复制代码
git clean -fd  # 删除未跟踪文件
  • 冲突文件恢复

解决合并冲突时,使用 --ignore-unmerged 避免意外覆盖:

shell 复制代码
git restore --ignore-unmerged .

参考文献

Git - git-restore Documentation

相关推荐
Doris_LMS1 小时前
Git的强软硬回退(三)
运维·服务器·数据库·git·idea
瓜酷月..1 小时前
GIT(了解)
git
misty youth7 小时前
git命令常用指南
git·github
持续迷茫9 小时前
lint-staged 中 --verbose 选项的深度解析
前端·git
lostElk9 小时前
团队 Git 分管理全流程规范
git·github
亦是行人!14 小时前
删除git中已经提交的target、logs、.idea文件
git
匆叔15 小时前
Git下载全攻略
前端·git
奇树谦17 小时前
Git配置:禁用全局HTTPS验证
git·网络协议·https
小安同学iter20 小时前
在idea当中git的基础使用
git
初级代码游戏1 天前
Git或TortoiseGit的小BUG(可解决):空库报错Could not get hash of ““
git·bug