Pembangun menyemak dua perubahan kod

Ramai pembangun—terutamanya yang baru bekerja dalam pasukan—menganggap merge conflict sebagai petanda mereka sudah merosakkan repositori. Hakikatnya, konflik cuma berlaku apabila dua orang menyunting baris yang sama (atau bersebelahan) pada fail yang sama dalam dua branch berbeza. Git tahu fail itu berubah, tetapi Git tidak tahu keputusan produk atau logik perniagaan mana yang patut dikekalkan.

Di situlah tugas manusia bermula. Menyelesaikan konflik bukan sekadar klik butang “Accept Current” atau “Accept Incoming” dalam VS Code sampai garis merah hilang. Klik secara membuta tuli ialah cara paling cepat untuk membuang pembetulan bug rakan sepasukan tanpa disedari.

Konflik bukan tanda kerja rosak

Apabila git merge atau git rebase berhenti dengan mesej konflik, langkah pertama ialah bertenang dan jalankan git status. Anda akan nampak senarai fail di bawah bahagian Unmerged paths. Kalau keadaan nampak terlalu kusut dan anda mahu berundur sekejap untuk semak semula branch asal, anda sentiasa boleh membatalkan proses itu dengan selamat menggunakan git merge --abort atau git rebase --abort.

Sebelum memilih baris mana yang menang, fahamkan cerita di sebalik kedua-dua perubahan. Buka pull request berkaitan atau jalankan git log -p -n 3 <laluan-fail> untuk melihat sejarah ringkas kenapa baris itu diubah. Mungkin branch anda menukar label mesej ralat untuk pengguna, manakala branch rakan anda membaiki syarat pengesahan input pada baris yang sama. Penyelesaian yang betul bukan memilih salah satu, tetapi menggabungkan kedua-dua maksud perubahan tersebut.

Aktifkan diff3 supaya nampak punca asal

Secara lalai, penanda konflik Git hanya memaparkan dua versi: blok HEAD (kod semasa anda) dan blok branch yang sedang digabungkan. Selalunya itu menyukarkan kita meneka apa rupa kod sebelum kedua-dua pihak mula menyunting.

Saya sangat sarankan tetapan zdiff3 (atau diff3 untuk versi Git lebih lama) dalam konfigurasi global Git anda:

git config --global merge.conflictstyle zdiff3

Dengan tetapan ini, Git menambah bahagian tengah yang ditandakan dengan |||||||:

<<<<<<< HEAD
const timeoutMs = 8000;
||||||| merged common ancestors
const timeoutMs = 3000;
=======
const timeoutMs = 5000;
>>>>>>> feature/retry-policy

Daripada contoh di atas, kita terus nampak nilai asal ialah 3000, satu branch menaikkan ke 5000 dan satu lagi ke 8000. Tanpa konteks punca asal, sukar untuk tahu nilai mana yang lebih baharu atau sengaja dinaikkan.

Konflik yang jangan disunting dengan tangan

Tidak semua fail patut diselesaikan baris demi baris dalam editor teks:

  • Fail lock seperti package-lock.json, yarn.lock, atau composer.lock. Jangan buang masa menyunting ratusan baris JSON yang berkonflik secara manual. Terima salah satu versi (contohnya git checkout --ours package-lock.json), kemudian jalankan npm install atau composer update --lock supaya pengurus pakej menjana semula struktur yang sah.
  • Fail migration atau snapshot pangkalan data (contohnya ModelSnapshot.cs dalam EF Core). Konflik pada snapshot biasanya bermaksud dua orang menjana migration secara selari. Kadang-kadang lebih bersih untuk menggugurkan migration branch sendiri sementara, tarik perubahan main, kemudian jana semula migration di atas state terkini.
  • Fail konfigurasi (.env.example, appsettings.json, nginx.conf). Berhati-hati jika dua branch menambah kunci baharu atau menamakan semula pemboleh ubah persekitaran yang sama. Fail mungkin tiada ralat sintaks JSON atau YAML selepas disunting, tetapi aplikasi masih boleh gagal semasa runtime kerana kunci yang dicari tidak sepadan.

Semak kesan sampingan selepas penanda dibuang

Selepas semua penanda <<<<<<<, ======= dan >>>>>>> dibuang, jangan terus git commit. Jalankan binaan atau ujian automatik yang berkaitan—sekurang-kurangnya dotnet build, npm run build, atau php -l bergantung pada projek anda—untuk memastikan tiada tanda kurung tertinggal, import yang hilang, atau pemboleh ubah pendua.

Selepas itu, tandakan fail selesai dengan git add <fail> dan semak git diff --staged buat kali terakhir sebelum commit. Jika konflik menyentuh logik kritikal seperti pengiraan harga, cukai, atau kawalan akses pengguna yang anda tidak pasti maksud asalnya, ajak pemilik branch satu lagi berbincang lima minit. Lima minit bertanya jauh lebih murah daripada membetulkan insiden produksi pada hujung minggu.