Branching, Merge
& Konflik

Branch adalah pointer ringan ke commit

Branch bukan salinan kode, melainkan pointer ringan yang menunjuk ke satu commit, dan itulah kenapa Git memberanikan kita membuatnya sesering apa pun.

Di Chapter 2 kita melihat histori sebagai rantai commit yang saling menunjuk ke parent-nya. Branch adalah lapisan di atas rantai itu: sebuah nama yang menyimpan satu hash commit. Tidak ada folder baru, tidak ada penggandaan file. Saat kamu menjalankan git branch feature/login, Git hanya menulis satu baris berisi hash ke dalam .git/refs/heads/. Itu sebabnya membuat branch terasa instan, bahkan pada repo dengan ratusan ribu commit.

Yang membuat branch terasa “hidup” adalah HEAD. HEAD adalah pointer ke branch yang sedang aktif, bukan langsung ke commit. Saat kamu commit, Git menambah commit baru lalu menggeser pointer branch yang ditunjuk HEAD untuk menunjuk commit baru itu. Branch lain tidak bergerak. Inilah mekanisme isolasi: pekerjaan di feature/login tidak menyentuh main sampai kamu memutuskan menggabungkannya.

flowchart LR
  C1["c1"] --> C2["c2"]
  C2 --> C3["c3 main"]
  C2 --> C4["c4 feature"]
  HEAD(["HEAD"]) -.-> C4

Branch sebagai pointer. main menunjuk c3, feature menunjuk c4, dan HEAD menandai feature sebagai branch aktif.

Di proyek skincare-backend, alur ini sangat praktis. Misalnya main memuat kode yang sudah jalan di produksi, sementara kamu sedang menggarap endpoint checkout. Kamu buat branch feature/checkout, bekerja bebas di sana, dan main tetap utuh siap dirilis kapan saja tanpa terkontaminasi kode setengah jadi.

Karena branch sangat murah, tim mengandalkan konvensi penamaan agar jalur kerja tetap terbaca. Nama branch yang konsisten membuat git branch dan daftar PR di hosting langsung bercerita tentang jenis pekerjaannya.

Untuk berpindah branch, perintah modern adalah git switch. Versi lama memakai git checkout yang memikul peran ganda (pindah branch sekaligus memulihkan file), sehingga Git memisahnya menjadi git switch dan git restore. git checkout masih ada dan berfungsi, tapi untuk berpindah branch sebaiknya pakai git switch agar niat kode lebih jelas.

TerminalSalin
# membuat dan langsung pindah ke branch baru
git switch -c feature/login
# ... edit file, lalu:
git add .
git commit -m "feat: tambah handler login"

# kembali ke main; commit feature/login tidak terbawa ke sini
git switch main
git log --oneline   # commit login tidak terlihat di main

git switch -c feature/login setara dengan git branch feature/login lalu git switch feature/login dalam satu langkah, jadi kamu langsung berada di ruang kerja baru.

Fast-forward versus three-way merge

Merge adalah cara Git menyatukan pekerjaan dari satu branch ke branch lain, dan hasilnya bergantung pada apakah base sudah bergerak sejak branch dibuat.

Setelah pekerjaan di feature/login selesai dan teruji, kamu ingin perubahannya masuk ke main. Caranya: pindah ke branch tujuan, lalu jalankan git merge. Git punya dua strategi yang dipilih otomatis tergantung bentuk histori, dan memahami keduanya membuat histori proyekmu lebih mudah dibaca.

Kasus pertama adalah fast-forward. Ini terjadi bila main tidak menerima commit baru sejak feature/login dipisah, sehingga commit main masih merupakan leluhur (ancestor) dari ujung feature. Karena tidak ada yang perlu didamaikan, Git cukup menggeser pointer main maju ke commit terakhir feature. Tidak ada commit baru yang dibuat; histori tetap satu garis lurus.

Kasus kedua adalah three-way merge. Ini terjadi bila kedua branch sama-sama maju: ada commit baru di main dan ada commit baru di feature. Git tidak bisa sekadar menggeser pointer karena keduanya menyimpang. Git mengambil tiga titik (ujung kedua branch dan commit leluhur bersama), menggabungkannya, lalu membuat merge commit yang istimewa karena punya dua parent.

gitGraph
  commit id: "c1"
  commit id: "c2"
  branch feature/login
  checkout feature/login
  commit id: "f1"
  commit id: "f2"
  checkout main
  commit id: "m1"
  merge feature/login id: "merge"

Three-way merge. Karena main maju dengan m1 dan feature dengan f1, f2, Git membuat merge commit berisi dua parent.

TerminalSalin
# pindah ke branch tujuan dulu
git switch main

# fast-forward bila main belum bergerak sejak feature dibuat
git merge feature/login
# Updating a1b2c3d..e4f5g6h
# Fast-forward

# memaksa merge commit walau sebenarnya bisa fast-forward
git merge --no-ff feature/login

Kapan memilih --no-ff? Flag ini memaksa Git membuat merge commit meski fast-forward sebenarnya mungkin. Banyak tim memakai ini agar serangkaian commit satu fitur tetap tampak sebagai satu gugus di histori.

Saat Git tidak bisa menggabungkan otomatis

Merge conflict bukan tanda ada yang rusak, melainkan momen Git jujur bahwa ia tidak punya cukup informasi untuk memilih gabungan yang benar, dan menyerahkan keputusan itu kepadamu.

Konflik muncul ketika dua branch mengubah baris yang sama pada file yang sama, atau satu sisi mengubah file sementara sisi lain menghapusnya. Untuk perubahan yang menyentuh baris berbeda, Git menggabungkan otomatis tanpa kamu sadari. Hanya saat dua sisi bertabrakan di baris yang persis sama, Git berhenti, menandai file, dan meminta penyelesaian manual.

Saat konflik terjadi, Git menyisipkan conflict marker ke dalam file. Ada tiga penanda: kepala <<<<<<< menandai awal versi branch saat ini (current), pemisah ======= membatasi kedua versi, dan ekor >>>>>>> menutup versi yang masuk (incoming). Tugasmu mengganti seluruh blok bertanda ini dengan versi final yang benar.

internal/order/service.go (saat konflik)Salin
func calcTotal(items []Item) int64 {
<<<<<<< HEAD
	var total PriceRupiah
	for _, it := range items {
		total += it.Price * int64(it.Qty)
	}
=======
	var total int64
	for _, it := range items {
		total += it.Subtotal
	}
>>>>>>> feature/discount
	return int64(total)
}

Setelah membaca kedua sisi, kamu menulis ulang blok itu menjadi satu versi yang menggabungkan maksud keduanya, lalu menghapus semua marker. Hasil resolusi bisa berupa gabungan ide dari kedua branch, bukan sekadar memilih salah satu mentah-mentah.

internal/order/service.go (setelah resolve)Salin
func calcTotal(items []Item) PriceRupiah {
	var total PriceRupiah
	for _, it := range items {
		total += it.Price*int64(it.Qty) - it.Discount
	}
	return total
}

Begitu file beres, kamu menandainya selesai dengan git add <file>, lalu menuntaskan merge dengan git commit. Bila ternyata situasinya terlalu rumit dan kamu ingin mundur, git merge --abort mengembalikan working tree ke kondisi sebelum merge dimulai, seolah merge tak pernah terjadi.

Dari satu garis lurus ke kerja paralel yang aman

Branch, merge, dan konflik adalah satu busur: memisah jalur, menyatukannya, dan menengahi saat keduanya bertabrakan.

Kamu kini bisa bekerja paralel tanpa takut. Branch adalah pointer murah yang mengisolasi pekerjaan, jaga umurnya pendek dan namai dengan konvensi. Merge menyatukannya, fast-forward saat linear, merge commit saat menyimpang, dengan --no-ff untuk menjaga jejak fitur. Dan konflik bukan kegagalan, melainkan undangan untuk memutuskan dengan membaca kedua sisi lalu memverifikasi dengan test. Sejauh ini semua masih lokal di mesinmu. Di Chapter 4 kita buka pintu ke tim: remote, Pull Request, dan branch protection.