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

この記事の内容

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

この機能を使用できるユーザー

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

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

GitHub.com 上のリポジトリでブランチの名前を変更できます。 ブランチの詳細については、「ブランチの概要)」を参照してください。

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

リポジトリの既定の名前の変更が変更されると、GitHub は、リポジトリのホームページに、コントリビューターにローカルの Git 環境を更新するよう指示が表示されます。

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

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

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

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

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

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

  3. 名前を変更するブランチの横にある をクリックします。

    ブランチ リスト内のブランチのスクリーンショット。 鉛筆アイコンがオレンジ色の枠線で強調表示されています。

  4. ブランチの新しい名前を入力します。

  5. ローカル環境についての情報を確認し、 [ブランチの名前変更] をクリックします。

ブランチ名の変更後にローカルクローンを更新する

GitHub Enterprise Cloud 上のリポジトリにあるブランチ名の変更後、そのリポジトリのローカルクローンのコラボレータは、クローンを更新する必要があります。

コンピュータ上にあるリポジトリのローカルクローンから、以下のコマンドを実行してデフォルトブランチ名を更新します。

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