Git
简体中文 ▾ Topics ▾ Latest version ▾ git-restore last updated in 2.43.0

名称

git-restore - 恢复工作树文件

概述

git restore [<options>] [--source=<tree>] [--staged] [--worktree] [--] <pathspec>…​
git restore [<options>] [--source=<tree>] [--staged] [--worktree] --pathspec-from-file=<file> [--pathspec-file-nul] 。
git restore (-p|--patch) [<options>] [--source=<tree>] [--staged] [--worktree] [--] [<pathspec>…​]

描述

用还原源的一些内容还原工作树中的指定路径。如果一个路径被跟踪，但在还原源中不存在，它将被删除以匹配源。

该命令还可以用来用`--staged`恢复索引中的内容，或者用`--staged --worktree`同时恢复工作树和索引。

默认情况下，如果给了`--staged`，内容将从`HEAD`恢复，否则从索引恢复。使用`--source`来恢复不同的提交。

关于这三个命令的区别，见git[1]中的 "重置、恢复和还原"。

这个命令是试验性的。其行为可能会改变。

选项

-s <tree>
--source=<tree>（来源）。

用给定树的内容恢复工作树的文件。通常是通过命名与之相关的提交、分支或标签来指定源树。

如果没有指定，如果给了`--staged`，则从`HEAD`恢复内容，否则从索引恢复。

作为一种特殊情况，如果正好有一个合并基数，你可以使用`"A…​B "作为`A`和`B`的合并基数的快捷方式。你最多可以漏掉`A`和`B`中的一个，在这种情况下，它默认为`HEAD`。

-p
--patch

交互式地选择还原源和还原位置之间的差异中的猎物。参见 git-add[1] 的 "互动模式 "部分，了解如何操作"--补丁 "模式。

请注意，`--patch`可以不接受任何pathspec，并会提示恢复所有修改的路径。

-W
--worktree
-S
--staged

指定恢复的位置。如果两个选项都没有指定，默认情况下会还原工作树。指定`--staged`将只恢复索引。指定两个选项将同时还原。

-q
--quiet

安静，抑制反馈信息。意味着"--没有进展"。

--progress
--no-progress

当它附加到终端时，除非指定 --quiet，否则默认情况下会在标准错误流中报告进度状态。这个标志可以启用进度报告，即使没有附在到终端，而不管 --quiet。

--ours
--theirs

When restoring files in the working tree from the index, use stage #2 (ours) or #3 (theirs) for unmerged paths. This option cannot be used when checking out paths from a tree-ish (i.e. with the --source option).

注意，在`git rebase`和`git pull --rebase`过程中，'我们的’和’他们的’可能会出现互换。详见 git-checkout[1] 中对相同选项的解释。

-m
--merge

When restoring files on the working tree from the index, recreate the conflicted merge in the unmerged paths. This option cannot be used when checking out paths from a tree-ish (i.e. with the --source option).

--conflict=<style>

The same as --merge option above, but changes the way the conflicting hunks are presented, overriding the merge.conflictStyle configuration variable. Possible values are "merge" (default), "diff3", and "zdiff3".

--ignore-unmerged

当从索引中恢复工作树上的文件时，如果有未合并的条目，并且没有指定`--我们的`、--他们的、--合并`或--冲突`，不要中止操作。工作树上未合并的路径将被忽略。

--ignore-skip-worktree-bits

In sparse checkout mode, the default is to only update entries matched by <pathspec> and sparse patterns in $GIT_DIR/info/sparse-checkout. This option ignores the sparse patterns and unconditionally restores any files in <pathspec>.

--recurse-submodules
--no-recurse-submodules

如果`<pathspec>命名了一个活动的子模块，并且恢复的位置包括工作树，只有在给出这个选项的情况下，子模块才会被更新，在这种情况下，它的工作树将被恢复到超级项目中记录的提交，并且任何本地修改都会被覆盖。如果什么都不使用（或--no-recurse-submodules`），子模块的工作树将不会被更新。就像git-checkout[1]，这将分离子模块的`HEAD`。

--overlay
--no-overlay

在覆盖模式下，该命令在恢复时不会删除文件。在无覆盖模式下，不出现在"--源 "树中的被追踪文件会被删除，以使它们与"<tree>"完全匹配。默认是无覆盖模式。

--pathspec-from-file=<file>

Pathspec在 <file> 中传递，而不是在命令行参数中传递。如果 <file> 正好是 -，则使用标准输入。Pathspec 元素由 LF 或 CR/LF 分隔。可以引用配置变量 core.quotePath 的 Pathspec 元素（请参见 git-config[1]）。另请参见 --pathspec-file-nul `和全局 `--literal-pathspecs。

--pathspec-file-nul

Only meaningful with --pathspec-from-file. Pathspec elements are separated with NUL character and all other characters are taken literally (including newlines and quotes).

--

不将之后的参数解释为选项。

<pathspec>…​

限制受操作影响的路径。

更多细节请参见 gitglossary[7] 中的 路径规范 条目。

实例

下面的序列切换到 "master "分支，将 "Makefile "恢复到两个修订版，错误地删除了hello.c，并从索引中取回它。

$ git switch master
$ git restore --source master~2 Makefile  (1)
$ rm -f hello.c
$ git restore hello.c                     (2)

  1. 将一个文件从另一个提交中取出

  2. 从索引中恢复 hello.c

如果你想恢复_所有的C源文件，使之与索引中的版本一致，你可以说

$ git restore '*.c'

注意 "*.c "周围的引号。 文件`hello.c`也将被恢复，尽管它已经不在工作树中了，因为文件globbing是用来匹配索引中的条目的（不是由shell在工作树中）。

要恢复当前目录下的所有文件

$ git restore .

或者用’top’pathspec魔法恢复所有工作树文件（见gitglossary[7]）。

$ git restore :/

将索引中的文件恢复到与`HEAD`中的版本一致（这与使用git-reset[1]相同）。

$ git restore --staged hello.c

or you can restore both the index and the working tree (this is the same as using git-checkout[1])

$ git restore --source=HEAD --staged --worktree hello.c

或更实用但可读性较差的简短形式。

$ git restore -s@ -SW hello.c

参见

git-checkout[1], git-reset[1]

GIT

属于 git[1] 文档

scroll-to-top