ブランチの名前を変更する

リポジトリにあるブランチの名前を変更できます。

この機能を使用できるユーザーについて

People with write permissions to a repository can rename a branch in the repository unless it is the default branch or covered by a branch protection or ruleset. People with admin permissions can rename the default branch and protected branches.

この記事で

ブランチの名前変更について

          GitHub.comのリポジトリ内のブランチの名前を変更できます。 ブランチの詳細については、「[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)」を参照してください。

ブランチの名前を変更すると、古いブランチ名を含む URL は、名前を変更されたブランチの同等の URL に自動的にリダイレクトされます。 ブランチ保護ポリシー、オープンなプルリクエストのベースブランチ (フォーク含む) およびドラフトリリースも更新されます。 名前を変更したブランチが、開いている pull request のヘッド ブランチである場合、この pull request は閉じられます。

リポジトリの既定のブランチの名前が変更された場合、 GitHub はリポジトリのホーム ページで、共同作成者にローカル Git 環境の更新を指示する手順を提供します。

ファイル URL は自動的にリダイレクトされますが、生のファイル URL はリダイレクトされません。 また、ユーザーが前のブランチ名のGitHubを実行した場合、git pullはリダイレクトを実行しません。

          GitHub Actions ワークフローは名前の変更に従わないので、リポジトリがアクションを発行すると、そのアクションを `@{old-branch-name}` で使用するすべてのユーザーが中断されます。 元のコンテンツを含む新しいブランチと、ブランチ名が 終了 されていることを報告する追加のコミットを追加し、ユーザーが新しいブランチ名に移行することを提案することを検討する必要があります。

ブランチの名前を変更できるユーザー

ほとんどのブランチは、リポジトリへの 書き込み アクセス許可を持つ任意のユーザーによって名前を変更できます。

一部のブランチは、リポジトリ管理者のみが名前を変更できます。リポジトリの既定のブランチと、ブランチ保護またはリポジトリ レベルのブランチ ルールセットの対象となるブランチ。

組織レベルまたはエンタープライズ レベルのルールセットがリポジトリ内のブランチを対象とする場合、通常、それらのブランチの名前を変更するには、組織またはエンタープライズ管理者が必要です。

ただし、組織と企業の所有者は、新しいブランチ名が現在の名前と同じ規則の対象である場合、リポジトリ管理者がこれらのルールセットの対象となるブランチの名前を変更することを許可できます。 既定のブランチを変更する場合でも、ルールセットが実行されている場合は、組織またはエンタープライズ管理者が必要です。

詳細については、「リポジトリ管理者が組織のルールセットを使用してブランチの名前を変更できるようにする」および「Enterprise でリポジトリ管理ポリシーを適用する」を参照してください。

リポジトリ管理者は、適切なアクセス許可を持っている限り、ブランチを作成および削除できます。

ブランチの名前を変更する

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. 左側のファイル ツリー ビューで、 ブランチ ドロップダウン メニューを選んでから、[View all branches] をクリックします。 統合ファイル エディターの上部にあるブランチ ドロップダウン メニューも見つかります。

    リポジトリのファイル ツリー ビューのスクリーンショット。 ブランチ用のドロップダウン メニューが展開され、濃いオレンジの枠線で囲まれています。

  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