git-checkout

Переключиться на <branch>. Текущей веткой становится <branch>, а файлы в вашем рабочем каталоге обновляются. Переключение не будет выполнено, если в каких-либо файлах есть незафиксированные изменения и содержимое этих файлов в <branch> отличается от содержимого в текущей фиксации. В остальных случаях незафиксированные изменения сохраняются.

Если <branch> не найдена, но в единственном удалённом репозитории существует отслеживаемая ветка (обозначим её <remote>) с таким же именем, а параметр --no-guess не указан, это равносильно выполнению команды

$ git checkout -b <branch> --track <remote>/<branch>

При запуске git checkout без указания ветки ничего не происходит, кроме вывода информации об отслеживании для текущей ветки.

Создать ветку с именем <new-branch>, указать в качестве её начальной точки <start-point> (по умолчанию — текущая фиксация) и переключиться на новую ветку. Параметры --track или --no-track позволяют настроить информацию об отслеживании вышестоящей ветки.

Операция завершится ошибкой, если не удастся переключиться на <new-branch>, например, если переключение на фиксацию <start-point> приведёт к перезаписи ваших незафиксированных изменений.

То же, что и -b, но если ветка уже существует, команда сбрасывает <branch> к начальной точке, а не завершает работу с ошибкой.

То же, что и git checkout <branch>, за исключением того, что вместо указания HEAD на ветку команда указывает HEAD на идентификатор фиксации. Подробнее см. раздел «ОТДЕЛЁННЫЙ HEAD» ниже.

Если не указывать <branch>, HEAD будет отсоединён на вершине текущей ветки.

Заменить указанные файлы и/или каталоги версиями из заданной фиксации или дерева и добавить их в индекс (также известный как «область подготовки»).

Например, команда git checkout main file.txt заменит file.txt версией из main.

Заменить указанные файлы и/или каталоги версиями из индекса.

Например, если вы переключились на фиксацию, отредактировали file.txt, а затем решили, что эти изменения были ошибкой, команда git checkout file.txt отменит все изменения в file.txt, ещё не добавленные в индекс.

Команда завершится ошибкой, если файл содержит конфликт слияния, а вы ещё не выполнили git add file.txt (или эквивалентную команду), чтобы отметить его как разрешённый. Чтобы вместо завершения с ошибкой игнорировать файлы с неразрешёнными конфликтами, можно использовать -f; чтобы заменить их версией с определённой стороны слияния — --ours или --theirs; а чтобы заменить их исходным результатом слияния с конфликтами — -m.

Этот режим похож на два предыдущих, но позволяет использовать интерактивный интерфейс, чтобы просмотреть вывод команды «diff» и выбрать блоки изменений для включения в результат. Описание параметра --patch см. ниже.

Не выводить сообщения обратной связи.

По умолчанию сведения о ходе выполнения передаются в стандартный поток ошибок, если он подключён к терминалу, если не указан параметр --quiet. Этот флаг включает вывод сведений о ходе выполнения, даже если поток не подключён к терминалу, независимо от --quiet.

При переключении веток продолжить операцию, даже если индекс или рабочее дерево отличаются от HEAD, а также если на пути находятся неотслеживаемые файлы. Этот параметр используется для удаления локальных изменений и любых мешающих неотслеживаемых файлов или каталогов.

При извлечении путей из индекса не завершать операцию с ошибкой при наличии неслитых записей; вместо этого игнорировать их.

При извлечении путей из индекса извлечь для неслитых путей вариант из этапа № 2 (ours) или № 3 (theirs).

Обратите внимание: во время git rebase и git pull --rebase значения ours и theirs могут поменяться местами; --ours указывает версию из ветки, на которую перемещаются изменения при перебазировании, а --theirs — версию из ветки с вашими изменениями, которые перебазируются.

Это объясняется тем, что rebase используется в рабочем процессе, где история на удалённом репозитории считается общей канонической историей, а работа, выполненная в перебазируемой ветке, рассматривается как сторонняя работа, которую нужно интегрировать. Во время перебазирования вы временно принимаете на себя роль хранителя канонической истории. Как хранитель канонической истории, вы должны рассматривать историю удалённого репозитория как ours (то есть «нашу общую каноническую историю»), а сделанное вами в отдельной ветке — как theirs (то есть «работу одного из участников поверх неё»).

Создать ветку с именем <new-branch>, начать её с <start-point> и переключиться на неё; подробности см. в git-branch[1].

То же, что и -b, за исключением того, что если ветка уже существует, <branch> сбрасывается к исходной точке вместо завершения с ошибкой.

При создании новой ветки настроить конфигурацию «вышестоящей» ветки. Подробности см. в разделе --track на странице git-branch[1]. Для удобства параметр --track без -b подразумевает создание ветки.

Если параметр -b не задан, имя новой ветки будет определено на основе ветки отслеживания удалённого репозитория: будет взята локальная часть refspec, настроенного для соответствующего удалённого репозитория, после чего начальная часть до «*» будет удалена. Например, при создании ветки от origin/hack это укажет использовать hack в качестве локальной ветки (или remotes/origin/hack, или даже refs/remotes/origin/hack). Если в указанном имени нет косой черты или в результате такого определения получится пустое имя, определение прерывается. В этом случае можно явно задать имя с помощью -b.

Не настраивать конфигурацию «вышестоящей» ветки, даже если переменная конфигурации branch.autoSetupMerge имеет значение true.

Если <branch> не найдена, но в единственном удалённом репозитории существует ветка отслеживания с таким же именем (назовём её <remote>), считать параметр эквивалентным

$ git checkout -b <branch> --track <remote>/<branch>

Если ветка существует в нескольких удалённых репозиториях и один из них указан переменной конфигурации checkout.defaultRemote, для устранения неоднозначности будет выбран именно он, даже если <branch> не является уникальным среди всех удалённых репозиториев. Например, задайте checkout.defaultRemote=origin, чтобы всегда переключаться на удалённые ветки из этого репозитория, если <branch> неоднозначно, но существует в удалённом репозитории origin. См. также checkout.defaultRemote на странице git-config[1].

--guess — поведение по умолчанию. Чтобы отключить его, используйте --no-guess.

Поведение по умолчанию можно задать с помощью переменной конфигурации checkout.guess.

Создать журнал ссылок новой ветки; подробности см. в git-branch[1].

Вместо переключения на ветку для работы с ней переключиться на коммит для просмотра и экспериментов, которые можно отбросить. Это поведение по умолчанию для git checkout <commit>, если <commit> не является именем ветки. Подробности см. в разделе «ОТДЕЛЁННЫЙ HEAD» ниже.

Создать новую ветку без коммитов с именем <new-branch>, начав её с <start-point>, и переключиться на неё. Первый коммит в этой новой ветке не будет иметь родителей и станет корнем новой истории, полностью не связанной с другими ветками и коммитами.

Индекс и рабочее дерево будут приведены в состояние, как если бы ранее была выполнена команда git checkout <start-point>. Это позволяет начать новую историю, в которой будет записан набор путей, похожий на <start-point>, выполнив команду git commit -a для создания корневого коммита.

Это может быть полезно, если нужно опубликовать дерево из коммита, не раскрывая всю его историю. Например, так можно опубликовать ветку проекта с открытым исходным кодом, дерево которой сейчас «чистое», но полная история содержит проприетарные или иным образом обременённые фрагменты кода.

Если нужно начать несвязанную историю, в которой будет записан набор путей, полностью отличный от набора в <start-point>, после создания ветки без предков следует очистить индекс и рабочее дерево, выполнив команду git rm -rf . из корневого каталога рабочего дерева. После этого можно подготовить новые файлы, заполнив рабочее дерево копированием из других мест, распаковкой tar-архива и т. п.

В режиме разреженного извлечения команда git checkout -- <path>... обновляет только записи, соответствующие <paths> и шаблонам разреженного извлечения в $GIT_DIR/info/sparse-checkout. Этот параметр игнорирует шаблоны разреженного извлечения и добавляет обратно все файлы из <path>....

При переключении веток, если у вас есть локальные изменения в одном или нескольких файлах, отличающихся между текущей веткой и веткой, на которую вы переключаетесь, команда откажется переключать ветки, чтобы сохранить изменения в контексте. С этим параметром конфликтующие локальные изменения автоматически сохраняются во временное хранилище перед переключением и применяются повторно после него. Если локальные изменения не пересекаются с различиями между ветками, переключение происходит без временного сохранения. Если при повторном применении временно сохранённых изменений возникают конфликты, запись сохраняется в списке временного хранилища. Устраните конфликты и по завершении выполните git stash drop либо очистите рабочее дерево (например, с помощью git reset --hard), а затем позднее выполните git stash pop, чтобы повторно применить изменения.

При извлечении путей из индекса этот параметр позволяет восстановить конфликтное слияние для указанных путей. Его нельзя использовать при извлечении путей из дерева.

То же, что и описанный выше параметр --merge, но изменяет способ отображения конфликтующих фрагментов, переопределяя переменную конфигурации merge.conflictStyle. Возможные значения: merge (по умолчанию), diff3 и zdiff3.

Интерактивно выбрать фрагменты различий между <tree-ish> (или индексом, если он не указан) и рабочим деревом. Выбранные фрагменты затем применяются к рабочему дереву в обратном направлении (а если указан <tree-ish>, то и к индексу).

Это означает, что с помощью git checkout -p можно выборочно отменять изменения в текущем рабочем дереве. О том, как работать в режиме --patch, см. раздел «Интерактивный режим» на странице git-add[1].

Обратите внимание: по умолчанию этот параметр использует режим без наложения (см. также --overlay); режим с наложением сейчас не поддерживается.

Создавать различия с <n> строками контекста. Количество строк контекста по умолчанию равно diff.context или 3, если переменная конфигурации не задана. (-U без <n> принимается без предупреждения как синоним -p из-за исторической особенности).

Показывать контекст между фрагментами различий, до указанного <number> строк, объединяя тем самым близко расположенные фрагменты. По умолчанию используется diff.interHunkContext или 0, если параметр конфигурации не задан.

Команда git checkout отказывается переключаться, если нужная ветка уже извлечена или используется другим рабочим деревом. Этот параметр позволяет всё равно переключиться на неё. Иными словами, одна ветка может использоваться более чем одним рабочим деревом.

При переключении веток без предупреждения перезаписывать игнорируемые файлы. Это поведение по умолчанию. Используйте --no-overwrite-ignore, чтобы прервать операцию, если в новой ветке есть игнорируемые файлы.

Использование --recurse-submodules обновит содержимое всех активных подмодулей в соответствии с коммитом, записанным в суперпроекте. Если локальные изменения в подмодуле будут перезаписаны, извлечение завершится ошибкой, если не использовать -f. Если не задано ничего (или задано --no-recurse-submodules), рабочие деревья подмодулей не обновляются. Как и git-submodule[1], эта команда отсоединит HEAD подмодуля.

В режиме наложения, используемом по умолчанию, команда git checkout никогда не удаляет файлы из индекса или рабочего дерева. При указании --no-overlay файлы, присутствующие в индексе и рабочем дереве, но отсутствующие в <tree-ish>, удаляются, чтобы точно привести их в соответствие с <tree-ish>.

Спецификация путей передаётся в <file> вместо аргументов командной строки. Если <file> равно в точности -, используется стандартный ввод. Элементы спецификации путей разделяются символом LF или CR/LF. Элементы спецификации путей можно заключать в кавычки, как описано для переменной конфигурации core.quotePath (см. git-config[1]). См. также --pathspec-file-nul и глобальный параметр --literal-pathspecs.

Имеет смысл только вместе с --pathspec-from-file. Элементы спецификации путей разделяются символом NUL, все остальные символы воспринимаются буквально (включая символы новой строки и кавычки).

Ветка для переключения; если параметр указывает на ветку (то есть имя, которое после добавления префикса «refs/heads/» является допустимой ссылкой), будет извлечена эта ветка. В противном случае, если он указывает на допустимый коммит, ваш HEAD станет «отделённым», и вы перестанете находиться в какой-либо ветке (подробности см. ниже).

Можно использовать синтаксис @{-N}, чтобы обратиться к N-й последней ветке или коммиту, на которые переключались с помощью команды «git checkout». Также можно указать -, что является синонимом @{-1}.

В особом случае можно использовать <rev-a>...<rev-b> как сокращённую запись базового коммита слияния для <rev-a> и <rev-b>, если такой базовый коммит ровно один. Можно опустить не более одного из <rev-a> и <rev-b>; в таком случае вместо него используется HEAD.

Имя новой ветки.

Имя коммита, с которого начинается новая ветка; подробности см. в git-branch[1]. По умолчанию используется HEAD.

В особом случае можно использовать <rev-a>...<rev-b> как сокращённую запись базового коммита слияния для <rev-a> и <rev-b>, если такой базовый коммит ровно один. Можно опустить не более одного из <rev-a> и <rev-b>; в таком случае вместо него используется HEAD.

Дерево, из которого выполняется извлечение (если указаны пути). Если параметр не задан, используется индекс.

В особом случае можно использовать <rev-a>...<rev-b> как сокращённую запись базового коммита слияния для <rev-a> и <rev-b>, если такой базовый коммит ровно один. Можно опустить не более одного из <rev-a> и <rev-b>; в таком случае вместо него используется HEAD.

Не интерпретировать следующие аргументы как параметры.

Ограничивает набор путей, затрагиваемых операцией.

Подробности см. в записи pathspec глоссария gitglossary[7].

Если выполнить команду git checkout <something> или git switch <something> и у вас есть только один удалённый репозиторий, Git может неявно переключиться на ветку и отслеживать, например, origin/<something>. Это перестаёт работать, если у вас есть более одного удалённого репозитория с ссылкой <something>. Эта настройка позволяет указать имя предпочтительного удалённого репозитория, который всегда будет выбираться при разрешении неоднозначности. Обычно в этом качестве указывают origin.

В настоящее время эта настройка используется командами git-switch[1] и git-checkout[1], когда команды git checkout <something> или git switch <something> переключаются на ветку <something> в другом удалённом репозитории, а также командой git-worktree[1], когда git worktree add указывает на удалённую ветку. В будущем эта настройка может использоваться другими командами или функциями, подобными checkout.

Задаёт значение по умолчанию для параметра --guess или --no-guess в командах git checkout и git switch. См. git-switch[1] и git-checkout[1].

Количество параллельных рабочих процессов, используемых при обновлении рабочего дерева. По умолчанию используется один рабочий процесс, то есть выполнение происходит последовательно. Если задано значение меньше единицы, Git использует столько рабочих процессов, сколько доступно логических ядер. Эта настройка и checkout.thresholdForParallelism влияют на все команды, выполняющие checkout, например checkout, clone, reset, sparse-checkout и т. д.

При выполнении параллельного checkout с небольшим количеством файлов затраты на запуск подпроцессов и межпроцессное взаимодействие могут превысить выигрыш от распараллеливания. Эта настройка позволяет определить минимальное количество файлов, при котором следует пытаться выполнить параллельный checkout. По умолчанию используется значение 100.