【Git】ブランチ名を変更する方法｜branch -m・4ステップ改名・master→main移行まで完全ガイド

# 現在ブランチを改名
git branch -m new-branch-name

# 別ブランチを指定して改名（チェックアウト不要）
git branch -m old-name new-name

# 既に new-name が存在する場合、-m ではエラー
# fatal: A branch named 'new-name' already exists.

# 強制上書き（既存ブランチを置き換える）
git branch -M new-name
# または
git branch -M old-name new-name

# 現在ブランチを改名（typo修正など）
git branch -m feature/login

# 確認
git branch --show-current
# → feature/login

# 別ブランチを改名（チェックアウトせずに）
git branch -m old-feature new-feature

# 全ブランチ一覧で確認
git branch

# STEP 1: ローカルを改名
git branch -m old-name new-name

# STEP 2: 新しい名前でpush（upstreamも同時設定）
git push origin -u new-name

# STEP 3: リモートの古いブランチを削除
git push origin --delete old-name

# STEP 4: リモート追跡情報を整理
git fetch --prune

# 状態確認
git branch -vv
# → new-name [origin/new-name] になっていればOK

# 旧ブランチ名と新ブランチ名を変数に
OLD=old-name
NEW=new-name

# 一連の処理
git branch -m "$OLD" "$NEW" && \
  git push origin -u "$NEW" && \
  git push origin --delete "$OLD" && \
  git fetch --prune

# STEP 1: 新ブランチ名でpushして新しいPRを先に作る
git branch -m old-name new-name
git push origin -u new-name

# STEP 2: 古いPRに「renameしたので #xxx で続き」とコメントしてクローズ
# STEP 3: 新PRで議論・レビューを続行

# STEP 4: 全てマージされた後、古いリモートブランチを削除
git push origin --delete old-name
git fetch --prune

# STEP 1: ローカルを改名
git branch -m master main

# STEP 2: 新ブランチをpush（upstream設定）
git push origin -u main

# STEP 3: GitHub/GitLab管理画面でdefault branchをmainに変更
# GitHub: Settings → Branches → Default branch → 切替ボタン
# GitLab: Settings → Repository → Default branch

# STEP 4: リモートのmaster を削除
git push origin --delete master

# STEP 5: origin/HEAD を新しいdefault branchに設定
git remote set-head origin main
# または自動検出
git remote set-head origin --auto

# STEP 6: ローカル追跡情報を整理
git fetch --prune

# 全リモート情報の最新化
git fetch --all --prune

# 古いmasterをローカルから削除
git branch -m master main-local-backup   # 念のため別名に退避（任意）
# または単純に削除
git branch -d master

# origin/HEAD を更新
git remote set-head origin --auto

# mainをローカルに作成（upstream設定）
git switch main

# 既にmainブランチが古い参照で残っている場合
git branch --set-upstream-to=origin/main main

# 現在のupstream確認
git branch -vv
# → * main 12ab34cd [origin/main] Commit message
# [] 内に追跡先が表示される。消えていたり古い名前なら設定が必要

# 新しいupstreamを設定
git branch --set-upstream-to=origin/new-name
# または短縮形
git branch -u origin/new-name

# 初回pushと同時に設定する場合
git push origin -u new-name

# upstream情報だけを解除（追跡関係を解除したい場合）
git branch --unset-upstream

# 作業を始めたがブランチ名がtypo
git branch --show-current
# → feture/login   ← ミス

# 改名
git branch -m feature/login

# 確認
git branch --show-current
# → feature/login

# 対象を確認
git branch | grep "^  feat-"

# パターン置換で一括改名（bash）
for branch in $(git branch | grep "^  feat-" | tr -d ' '); do
  new_name=$(echo "$branch" | sed 's|feat-|feature/|')
  git branch -m "$branch" "$new_name"
  echo "renamed: $branch -> $new_name"
done

# 未pushブランチのみを想定。push済みは個別に上記4ステップを実行

# 4ステップを実行
git branch -m feature/wrong-name feature/correct-name
git push origin -u feature/correct-name
git push origin --delete feature/wrong-name
git fetch --prune

# 他メンバーがまだpullしていないことを確認（Slack/PRで周知）
# PRがあれば新ブランチで作り直すか、PRページの「Rename branch」を使う

# 最新情報を取得＋削除済みブランチを整理
git fetch --all --prune

# 旧名ブランチが手元にあれば改名
git branch -m old-name new-name

# 新しいupstreamを設定
git branch -u origin/new-name

# 状態確認
git branch -vv
# → new-name [origin/new-name] になっていればOK

# default branchが変わった場合
git remote set-head origin --auto