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-Barudanfitur-barudianggap 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.
originadalah remote utama hasil clone atau fork milikmu.upstreamhanya 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 --prunedan 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.