Переименование ветви

Сведения о переименовании ветвей

Вы можете переименовать ветку в репозитории на GitHub.com. Дополнительные сведения о ветвях см. в разделе О ветвях.

При переименовании ветви все URL-адреса, содержащие старое имя ветви, автоматически перенаправляются на эквивалентный URL-адрес переименованной ветви. Также обновятся политики защиты ветвей, базовая ветвь для открытых запросов на вытягивание (в том числе и для вилок) и черновики выпусков. Если переименованная ветвь является главная ветвь открытого запроса на вытягивание, этот запрос на вытягивание закрывается.

Если ветка репозитория по умолчанию переименована, на GitHub главной странице репозитория отображаются инструкции, направляющие участников обновлять локальные Git-среды.

В отличие от URL-адресов файлов, не происходит автоматическое перенаправление URL-адресов необработанных файлов. Также GitHub не выполняет перенаправления, если пользователи выполняют a git pull для предыдущего имени ветки.

          GitHub Actions Рабочие процессы не следуют за переименованием, поэтому если ваш репозиторий публикует действие, любой, кто использует это `@{old-branch-name}` действие, сломается. Стоит рассмотреть возможность добавления новой ветки с оригинальным содержимым, а также дополнительного коммита с указанием названия закрытие ветки и предложения мигрировать на новое имя ветки.

Кто может переименовать филиал

Большинство ветвей может быть переименовано любым пользователем с разрешением записи в репозиторий.

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

Когда наборы правил на уровне организации или предприятия нацелены на ветки репозитория, переименование этих ветвей обычно требует участия администратора организации или предприятия.

Однако владельцы организаций и предприятий могут разрешить администраторам репозиториев переименовывать филиалы, подпадающие под эти правила, при условии, что новое название ветки по-прежнему подчиняется тем же правилам, что и текущее название. Изменение стандартной ветки всё равно требует участия администратора организации или предприятия, когда используются правила.

Дополнительные сведения см. в разделе [AUTOTITLE и Разрешение администраторам репозиториев переименовывать ветки с наборами правил организации](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-renaming-protected-branches).

Администраторы репозитория могут создавать и удалять ветви до тех пор, пока у них есть соответствующие разрешения.

Переименование ветви

1. На GitHubперейдите на главную страницу репозитория.

2. В представлении дерева файлов слева выберите раскрывающееся меню "git-branch" aria-hidden="true" aria-label="git-branch" %} в раскрывающемся меню "git-branch" %} и выберите команду Просмотреть все ветви. Вы также можете найти раскрывающееся меню ветви в верхней части интегрированного редактора файлов.

   

3. Рядом с веткой, которую хотите переименовать, выберите выпадающее меню и нажмите «Переименовать ветку».

4. Введите новое имя ветви.

5. Просмотрите сведения о локальных средах и щелкните Переименовать ветвь.

Обновление локального клона после изменения имени ветви

После переименования ветки в репозитории на GitHub, любому соавтору с локальным клоном репозитория нужно обновить клон.

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

git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
git fetch origin
git branch -u origin/NEW-BRANCH-NAME NEW-BRANCH-NAME
git remote set-head origin -a

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

git remote prune origin