Cara Rename Branch GitHub Lokal dan Remote agar Sinkron

Cara rename branch GitHub yang sinkron butuh dua tahap. Git lokal tidak punya perintah rename remote. Kamu rename branch di lokal dengan git branch -m, push branch baru ke GitHub, lalu hapus branch lama di remote. Tanpa tahap push dan hapus itu, GitHub tetap menampilkan nama lama.

Bedakan konteksnya. Rename lokal saja cukup kalau branch belum pernah di-push. Kalau branch sudah ada di GitHub, wajib sinkron manual agar histori pull, Pull Request, dan clone anggota tim tidak pecah.

Rename Branch Lokal dan Sinkron ke Remote GitHub

Ikuti urutan ini agar tidak kehilangan commit:

1. Cek status kerja aman:

git status
git branch --show-current

2. Rename branch lokal:

git branch -m fitur-baru

3. Push branch baru dan pasang upstream:

git push -u origin fitur-baru

4. Hapus branch lama di GitHub:

git push origin --delete fitur-lama

5. Verifikasi remote dan tracking:

git fetch --prune
git branch -vv

Perintah Rename untuk Branch Aktif dan Branch Lain

Untuk branch yang sedang dibuka:

git branch -m nama-baru

Untuk branch lain tanpa pindah posisi:

git branch -m nama-lama nama-baru
  • Working tree harus bersih. Commit atau stash dulu perubahan yang belum disimpan.
  • Tidak boleh ada branch lokal lain dengan nama tujuan yang sama.
  • Git membedakan huruf besar dan kecil. Fitur-Baru dan fitur-baru dianggap berbeda.

Tabel Perintah Rename dan Sinkronisasi Remote

Command Fungsi Catatan
git branch -m Rename branch lokal Hanya mengubah lokal
git push -u origin nama-baru Kirim branch baru ke GitHub Atur upstream sekalian
git push origin --delete nama-lama Hapus branch lama di remote Tidak bisa dibatalkan mudah

Jangan hapus branch remote sebelum branch baru berhasil di-push dan terlihat di GitHub. Jangan memakai force push untuk rename biasa karena rename lewat push branch baru tidak menulis ulang history.

  • origin adalah remote utama hasil clone atau fork milikmu.
  • upstream hanya dipakai kalau kamu memang menambahkan remote ke repository asal hasil fork.

Rename Branch Default dan Branch yang Sudah Ada Pull Request

Branch default seperti main lebih aman di-rename dari halaman Branches di GitHub. Setelah itu sinkronkan lokal:

git fetch origin
git branch -m main nama-baru
git branch --set-upstream-to=origin/nama-baru

Pull Request yang masih open umumnya mengikuti nama branch baru selama source branch tidak dihapus permanen. Link lama, branch protection rule, dan workflow Actions yang menyebut nama lama bisa berhenti cocok.

  • Update base atau head Pull Request bila perlu.
  • Perbarui branch protection untuk nama baru.
  • Minta semua anggota tim menjalankan fetch --prune dan memperbaiki upstream lokal.
  • Perbarui skrip deploy dan Actions yang memakai nama branch lama.

FAQ

Apakah rename branch lokal otomatis mengubah branch di GitHub?

Tidak. GitHub tetap menyimpan nama lama sampai kamu push nama baru dan hapus nama lama.

Bagaimana memperbaiki upstream salah setelah rename branch?

Jalankan git push -u origin nama-baru untuk memasang ulang tracking ke branch yang benar.

Apakah Pull Request ikut pindah setelah branch di-rename?

Pull Request open biasanya tetap terhubung ke branch baru, tetapi periksa target, protection, dan workflow-nya.