команда git restore

Основные операции Git


git restore Команда используется для восстановления или отмены изменений в файлах.

git restoreКоманда была введена в Git версии 2.23, чтобы упростить и улучшить операции восстановления файлов. По сравнению со старыми командами (такими какgit checkoutиgit reset), она в большей степени ориентирована на восстановление содержимого файлов и состояния рабочего дерева.

git restoreОна может восстанавливать файлы в рабочем дереве и области подготовленных изменений, а также использоваться для отмены незакоммиченных изменений.

Базовый синтаксис

git restore [<options>] [<pathspec>...]
  • <pathspec>: Путь к файлу или каталогу для восстановления.
  • <options>: Параметры для настройки поведения восстановления.

Общие параметры и использование

ПараметрыОписаниеПример использования
--source=<commit>Восстановить содержимое файлов из указанного коммита. По умолчанию используется HEAD, то есть текущий коммит.git restore --source=HEAD~1 file.txt
--stagedВосстановить содержимое файлов из области подготовленных изменений в рабочее дерево, а не восстанавливать содержимое в рабочем дереве.git restore --staged file.txt
--worktreeВосстановить содержимое файлов в рабочем дереве до текущего состояния рабочего дерева.git restore --worktree file.txt
--oursВ случае конфликта слияния восстановить версию текущей ветки (то есть версию "ours").git restore --ours file.txt
--theirsВ случае конфликта слияния восстановить версию другой ветки (то есть версию "theirs").git restore --theirs file.txt
--conflict=<style>Указать стиль конфликтов слияния, напримерmergeилиdiff3。git restore --conflict=diff3 file.txt
--dry-runПоказать файлы и пути, которые будут восстановлены, без фактического выполнения восстановления.git restore --dry-run
-s, --sourceи--sourceТо же самое, используется для восстановления файлов из указанного коммита.git restore -s HEAD~1 file.txt
-W, --worktreeВосстановить содержимое файлов в рабочем дереве до текущего состояния рабочего дерева (с--worktreeтот же).git restore -W file.txt
-S, --stagedВосстановить содержимое файлов из области подготовленных изменений в рабочее дерево, а не восстанавливать содержимое в рабочем дереве (с--stagedтот же).git restore -S file.txt

Пример

Восстановить файлы в рабочем дереве

Восстановить файлы в рабочем дереве до состояния последнего коммита (т. е. отменить все незакоммиченные изменения в файлах):

git restore file.txt

Восстановить файлы в области подготовленных изменений

Восстановить файлы, находящиеся в области подготовленных изменений, в рабочее дерево, что фактически удаляет файлы из области подготовленных изменений (без создания коммита):

git restore --staged file.txt

Восстановить файлы из указанного коммита

Восстановить файлы из конкретного коммита (например, HEAD~1):

git restore --source=HEAD~1 file.txt

Восстановить версию файла «ours»

В случае конфликта слияния восстановить до версии текущей ветки (т. е. версии «ours»):

git restore --ours file.txt

Восстановить версию "theirs" для файла

В случае конфликта слияния восстановить версию из другой ветки (то есть версию "theirs"):

git restore --theirs file.txt

Показать файлы и пути, подлежащие восстановлению

Показать файлы и пути, которые будут восстановлены, без фактического выполнения восстановления:

git restore --dry-run

Восстановить несколько файлов

Восстановить несколько файлов в рабочем дереве:

git restore file1.txt file2.txt


Основные операции Git

Другие расширения