git-branch

Удалить ветку. Ветка должна быть полностью слита с вышестоящей веткой или с HEAD, если вышестоящая ветка не была настроена с помощью --track или --set-upstream-to.

Сокращённая запись для --delete --force.

Создать журнал ссылок для ветки. Это включает запись всех изменений, внесённых в ссылку на ветку, и позволяет использовать выражения sha1, основанные на дате, например <branch-name>@{yesterday}. Обратите внимание: в репозиториях, не являющихся репозиториями без рабочего дерева, журналы ссылок обычно включены по умолчанию параметром конфигурации core.logAllRefUpdates. Отрицательная форма --no-create-reflog переопределяет только предшествующий параметр --create-reflog, но в настоящее время не отменяет настройку core.logAllRefUpdates.

Переместить <branch-name> на <start-point>, даже если <branch-name> уже существует. Без -f команда git branch отказывается изменять существующую ветку. В сочетании с -d (или --delete) разрешает удаление ветки независимо от того, слита ли она и указывает ли она вообще на допустимый коммит. В сочетании с -m (или --move) разрешает переименование ветки, даже если новое имя ветки уже существует; то же относится к -c (или --copy).

Обратите внимание: git branch -f <branch-name> [<start-point>] отказывается изменять существующую ветку <branch-name>, если на неё переключено другое рабочее дерево, связанное с тем же репозиторием, даже при наличии параметра -f.

Переместить или переименовать ветку вместе с её конфигурацией и журналом ссылок.

Сокращённая запись для --move --force.

Копировать ветку вместе с её конфигурацией и журналом ссылок.

Сокращённая запись для --copy --force.

Раскрашивать ветки, чтобы выделять текущую, локальные ветки и ветки удалённого отслеживания. Значением должно быть always (по умолчанию), never или auto.

Отключить раскраску веток, даже если в файле конфигурации задана раскраска вывода по умолчанию. То же, что и --color=never.

Сортировать и фильтровать ветки без учёта регистра.

Не выводить символ перевода строки после форматированных ссылок, если формат раскрывается в пустую строку.

Выводить список веток в виде столбцов. Синтаксис параметров см. в переменной конфигурации column.branch. --column и --no-column без параметров эквивалентны соответственно always и never.

Этот параметр применяется только в режиме без подробного вывода.

Сортировать по <key>. Добавьте перед ключом -, чтобы сортировать значения по убыванию. Параметр --sort=<key> можно указать несколько раз; в таком случае последний ключ становится основным. Поддерживаются те же ключи, что и в git-for-each-ref[1]. Порядок сортировки по умолчанию определяется значением переменной branch.sort, если она задана, или сортировкой по полному имени ссылки (включая префикс refs/...). Сначала выводится отсоединённый HEAD (если он есть), затем локальные ветки и, наконец, ветки удалённого отслеживания. См. git-config[1].

Вывести список веток удалённого отслеживания или удалить их (если используется вместе с -d). Сочетайте с --list, чтобы сопоставить необязательные шаблоны.

Вывести список веток удалённого отслеживания и локальных веток. Сочетайте с --list, чтобы сопоставить необязательные шаблоны.

Вывести список веток. Если указаны необязательные <pattern>..., например git branch --list maint-*', выводятся только ветки, соответствующие шаблонам.

Вывести имя текущей ветки. В состоянии отсоединённого HEAD ничего не выводится.

В режиме вывода списка показать для каждой вершины sha1 и строку темы коммита, а также отношение к вышестоящей ветке (если она есть). Если параметр указан дважды, также вывести путь связанного рабочего дерева (если оно есть) и имя вышестоящей ветки (см. также git remote show <remote>). Обратите внимание: путь для HEAD текущего рабочего дерева не выводится (в качестве пути всегда используется текущий каталог).

Не выводить лишние сообщения при создании или удалении ветки, подавляя сообщения, не связанные с ошибками.

В подробном списке, где выводится имя объекта коммита, показать кратчайший префикс длиной не менее <n> шестнадцатеричных цифр, однозначно указывающий на объект. Значение по умолчанию — 7; его можно переопределить параметром конфигурации core.abbrev.

Выводить в списке полные значения sha1, не сокращая их.

При создании новой ветки задать записи конфигурации branch.<name>.remote и branch.<name>.merge, чтобы настроить отслеживание «вышестоящей» ветки для новой ветки. Эта конфигурация указывает Git показывать связь между двумя ветками в командах git status и git branch -v. Кроме того, она указывает git pull без аргументов получать изменения из вышестоящей ветки, когда выполнено переключение на новую ветку.

Конкретная вышестоящая ветка выбирается в зависимости от необязательного аргумента: -t, --track или --track=direct означает, что в качестве вышестоящей используется сама ветка начальной точки; --track=inherit означает копирование конфигурации вышестоящей ветки из ветки начальной точки.

Переменная конфигурации branch.autoSetupMerge задаёт поведение команд git switch, git checkout и git branch, если не указаны ни --track, ни --no-track:

Параметр по умолчанию true действует так, как если бы был указан --track=direct, когда начальная точка является веткой удалённого отслеживания. false действует так, как если бы был указан --no-track. always действует так, как если бы был указан --track=direct. inherit действует так, как если бы был указан --track=inherit. simple действует так, как если бы был указан --track=direct, только если <start-point> является веткой удалённого отслеживания, а новая ветка имеет то же имя, что и удалённая ветка.

Дополнительные сведения об использовании параметров branch.<name>.remote и branch.<name>.merge см. в git-pull[1] и git-config[1].

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

ЭТОТ ПАРАМЕТР ЭКСПЕРИМЕНТАЛЬНЫЙ! Если включён параметр submodule.propagateBranches, текущая команда рекурсивно выполняется в подмодулях. См. submodule.propagateBranches в git-config[1]. В настоящее время поддерживается только создание веток.

При создании ветки с этим параметром новая ветка <branch-name> будет создана в суперпроекте и во всех подмодулях из <start-point> суперпроекта. В подмодулях ветка будет указывать на коммит подмодуля, указанный в <start-point> суперпроекта, но данные отслеживания ветки будут настроены на основе веток и удалённых репозиториев подмодуля; например, git branch --recurse-submodules topic origin/main создаст в подмодуле ветку "topic", указывающую на коммит подмодуля в "origin/main" суперпроекта, но отслеживающую "origin/main" подмодуля.

Этот параметр больше не поддерживается из-за запутанного синтаксиса. Вместо него используйте --track или --set-upstream-to.

Настроить данные отслеживания для <branch-name> так, чтобы <upstream> считалась вышестоящей веткой для <branch-name>. Если <branch-name> не указан, по умолчанию используется текущая ветка.

Удалить сведения о вышестоящей ветке для <branch-name>. Если ветка не указана, по умолчанию используется текущая ветка.

Открыть редактор и изменить текстовое описание назначения ветки, используемое различными другими командами (например, format-patch, request-pull и merge, если эта функция включена). Описание может состоять из нескольких строк.

Выводить только ветки, содержащие <commit> (если он не указан, используется HEAD). Подразумевает --list.

Выводить только ветки, не содержащие <commit> (если он не указан, используется HEAD). Подразумевает --list.

Выводить только ветки, вершины которых достижимы из <commit> (если он не указан, используется HEAD). Подразумевает --list.

Выводить только ветки, вершины которых недостижимы из <commit> (если он не указан, используется HEAD). Подразумевает --list.

Выводить только ветки, указывающие на <object>.

Строка, подставляющая значения %(fieldname) для отображаемой ссылки на ветку и объекта, на который она указывает. <format> совпадает с тем, что используется в git-for-each-ref[1].

Имя создаваемой или удаляемой ветки. Новое имя ветки должно пройти все проверки, определённые в git-check-ref-format[1]. Некоторые из этих проверок могут ограничивать допустимые символы в имени ветки.

Новая вершина ветки будет указывать на этот коммит. Его можно задать как имя ветки, идентификатор коммита или тег. Если этот параметр опущен, вместо него используется текущий HEAD.

Имя существующей ветки. Если этот параметр опущен, вместо него используется имя текущей ветки.

Новое имя существующей ветки. Применяются те же ограничения, что и для <branch-name>.

Указывает git branch, git switch и git checkout настраивать новые ветки так, чтобы git-pull[1] корректно выполнял слияние с исходной веткой. Обратите внимание: даже если этот параметр не задан, такое поведение можно выбрать для каждой ветки отдельно с помощью параметров --track и --no-track. По умолчанию для этого параметра установлено значение true. Допустимые значения:

Если новая ветка создаётся с помощью git branch, git switch или git checkout и отслеживает другую ветку, эта переменная указывает Git настроить выполнение перебазирования вместо слияния при получении изменений (см. branch.<name>.rebase). Допустимые значения:

Подробные сведения о настройке отслеживания одной веткой другой ветки см. в разделе branch.autoSetupMerge. По умолчанию для этого параметра установлено значение never.

Эта переменная управляет порядком сортировки веток, отображаемых командой git-branch[1]. Если параметр --sort=<value> не указан, значение этой переменной используется по умолчанию. Допустимые значения см. в названиях полей git-for-each-ref[1].

Находясь в ветке <name>, этот параметр указывает git fetch и git push, с какого удалённого репозитория получать изменения или в какой отправлять их. Удалённый репозиторий для отправки изменений можно переопределить с помощью remote.pushDefault (для всех веток). Удалённый репозиторий для отправки изменений из текущей ветки можно дополнительно переопределить с помощью branch.<name>.pushRemote. Если удалённый репозиторий не настроен или если вы не находитесь ни в одной ветке, а в репозитории определено несколько удалённых репозиториев, для получения изменений по умолчанию используется origin, а для отправки — remote.pushDefault. Кроме того, . (точка) обозначает текущий локальный репозиторий (репозиторий с точкой); см. заключительное примечание ниже к branch.<name>.merge.

Находясь в ветке <name>, этот параметр переопределяет branch.<name>.remote для отправки изменений. Он также переопределяет remote.pushDefault при отправке изменений из ветки <name>. Если вы получаете изменения из одного места (например, из вышестоящего репозитория), а отправляете в другое (например, в собственный репозиторий для публикации), задайте remote.pushDefault, чтобы указать удалённый репозиторий для отправки изменений из всех веток, а этот параметр используйте для переопределения настройки для отдельной ветки.

Вместе с branch.<name>.remote определяет вышестоящую ветку для указанной ветки. Параметр указывает git fetch/git pull/git rebase, с какой веткой выполнять слияние, и также может влиять на git push (см. push.default). Находясь в ветке <name>, он указывает git fetch спецификацию ссылки по умолчанию, которую следует пометить для слияния в FETCH_HEAD. Значение обрабатывается как часть спецификации ссылки, указывающая удалённый репозиторий, и должно соответствовать ссылке, получаемой из удалённого репозитория, заданного параметром branch.<name>.remote. Информация о слиянии используется командой git pull (которая сначала вызывает git fetch) для поиска ветки слияния по умолчанию. Без этого параметра git pull по умолчанию выполняет слияние по первой полученной спецификации ссылки. Укажите несколько значений, чтобы выполнить слияние типа «осьминог». Если вы хотите настроить git pull так, чтобы он выполнял слияние в <name> из другой ветки локального репозитория, укажите нужную ветку в branch.<name>.merge и задайте для branch.<name>.remote относительный путь . (точку).

Задаёт параметры по умолчанию для слияния в ветку <name>. Синтаксис и поддерживаемые параметры совпадают с таковыми у git-merge[1], однако значения параметров, содержащие пробельные символы, в настоящее время не поддерживаются.

Если значение равно true, при выполнении команды git pull ветка <name> перебазируется поверх полученной ветки вместо слияния с веткой по умолчанию из удалённого репозитория по умолчанию. О настройке такого поведения без привязки к конкретной ветке см. pull.rebase.

Если значение равно merges (или просто m), команде git rebase передаётся параметр --rebase-merges, чтобы локальные коммиты слияния включались в перебазирование (подробности см. в git-rebase[1]).

Если значение равно interactive (или просто i), перебазирование выполняется в интерактивном режиме.

ПРИМЕЧАНИЕ: эта операция может быть опасной; не используйте её, если не понимаете возможных последствий (подробности см. в git-rebase[1]).

Описание ветки; его можно отредактировать с помощью git branch --edit-description. Описание ветки автоматически добавляется в сопроводительное письмо format-patch или в сводку request-pull.