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

相关推荐
小前端学徒1 小时前
重新修改未提交到远程分支不是最后一次commit的内容
git
执键行天涯2 小时前
idea中已经被git缓存追踪的文件,如何让git重新忽略
git·缓存·intellij-idea
hkhkhkhkh1232 小时前
Git push 失败(remote unpack failed: Missing tree)解决方案
linux·git
拾贰_C3 小时前
【anaconda】anaconda安装配置,git安装配置以及pytorch安装
人工智能·pytorch·git
Just_Paranoid6 小时前
【Gerrit Patch】批量下载 Gerrit 提交的 Patch
git·gerrit·shell·patch
T - mars19 小时前
Pycharm中使用git
ide·git·pycharm
jason_yang20 小时前
Workspace搭建Vue3+组件分离的Monorepo项目
git·npm·前端工程化
鸽鸽程序猿1 天前
【Git】Git 简介及基本操作
git
ziyue75751 天前
idea终端添加git-bash,支持linux的shell语法
linux·git·bash·idea·软件
风也温柔☆2 天前
idea 拉取分支git pull报错 The branch to pull from should be selected
git·intellij-idea·debug·git pull