SYNOPSIS

'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>...]

DESCRIPTION

復元ソースからのコンテンツを使用して、作業ツリー内の指定されたパスを復元します。パスが追跡されているが、復元ソースに存在しない場合、復元ソースと一致するように削除されます。

このコマンドを使用して、 --staged を使用してインデックスのコンテンツを復元したり、 --staged--worktree を使用して作業ツリーとインデックスの両方を復元したりすることもできます。

デフォルトでは、 --staged が指定されている場合、コンテンツは HEAD から復元され、そうでない場合はインデックスから復元されます。別のコミットから復元するには、 --source を使用します。

3つのコマンドの違いについては、 git(1) の "Reset, restore and revert" を参照してください。

!!このコマンドは実験的なものです。 動作が変わる可能性があります!!

OPTIONS

-s <tree>
--source=<tree>

Restore the working tree files with the content from the given tree. It is common to specify the source tree by naming a commit, branch or tag associated with it.

このオプションを指定しない場合で、 --staged が指定されている場合は HEAD から、それ以外の場合はインデックスから内容が復元されます。

特別な場合として、マージベースが1つしかない場合は、 A と B のマージベースのショートカットとして A...B を使用できます。 A と B の片方を省略できます。その場合、省略した方はデフォルトで HEAD になります。

-p
--patch

Interactively select hunks in the difference between the restore source and the restore location. See the “Interactive Mode” section of git-add(1) to learn how to operate the --patch mode.

注意: --patch はpathspecを受け入れることができず、変更されたすべてのパスを復元するように求められることに注意してください。

-W
--worktree
-S
--staged

Specify the restore location. If neither option is specified, by default the working tree is restored. Specifying --staged will only restore the index. Specifying both restores both.

-q
--quiet

Quiet, suppress feedback messages. Implies --no-progress.

--progress
--no-progress

Progress status is reported on the standard error stream by default when it is attached to a terminal, unless --quiet is specified. This flag enables progress reporting even if not attached to a terminal, regardless of --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 での作業中、「ours」と「theirs」が入れ替わっているように見える場合があることに注意してください。 詳細については、 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

When restoring files on the working tree from the index, do not abort the operation if there are unmerged entries and neither --ours, --theirs, --merge or --conflict is specified. Unmerged paths on the working tree are left alone.

--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

If <pathspec> names an active submodule and the restore location includes the working tree, the submodule will only be updated if this option is given, in which case its working tree will be restored to the commit recorded in the superproject, and any local modifications overwritten. If nothing (or --no-recurse-submodules) is used, submodules working trees will not be updated. Just like git-checkout(1), this will detach HEAD of the submodule.

--overlay
--no-overlay

In overlay mode, the command never removes files when restoring. In no-overlay mode, tracked files that do not appear in the --source tree are removed, to make them match <tree> exactly. The default is no-overlay mode.

--pathspec-from-file=<file>

Pathspec is passed in <file> instead of commandline args. If <file> is exactly - then standard input is used. Pathspec elements are separated by LF or CR/LF. Pathspec elements can be quoted as explained for the configuration variable core.quotePath (see git-config(1)). See also --pathspec-file-nul and global --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) の「pathspec」エントリを参照してください。

EXAMPLES

以下のシーケンスは、 master ブランチに切り替え、Makefile を2つ前のリビジョンに戻し、誤って 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 は、作業ツリーに存在しなくなった場合でも復元されます。これは、ファイルグロブがインデックス内のエントリを照合するために使用されるためです(シェルによる作業ツリー内ではありません)。

現在のディレクトリ内のすべてのファイルを復元するには

$ 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

SEE ALSO

git-checkout(1), git-reset(1)

GIT

Part of the git(1) suite