Pembangun memindahkan perubahan kod antara branch

Bayangkan situasi petang Jumaat di pejabat: dalam branch develop, sudah ada belasan commit untuk modul baharu yang masih separuh siap dan belum sedia untuk diuji oleh pengguna. Tiba-tiba pasukan sokongan melaporkan satu pepijat kecil di produksi — contohnya pengiraan penggenapan sen pada invois SST 8% tersasar satu sen — dan pembetulan untuk pepijat itu kebetulan sudah pun ada sebagai satu commit di dalam develop.

Menggabungkan keseluruhan develop ke main bukan pilihan yang selamat kerana ia akan membawa sekali kod yang belum siap. Di sinilah git cherry-pick menjadi penyelamat yang sangat berguna, asalkan kita faham apa yang berlaku di belakang tabir.

Semak kebergantungan sebelum memetik commit

git cherry-pick menyalin perubahan daripada satu commit tertentu dan menerapkannya sebagai commit baharu di atas branch sasaran. Ia nampak ringkas, tetapi kesilapan paling biasa ialah menyangka setiap commit berdiri secara bersendirian.

Sebelum menyalinnya ke main, semak dahulu sejarah dan diff commit tersebut:

git log --oneline -n 10 develop
git show a1b2c3d

Perhatikan fail yang disentuh. Jika commit itu memanggil fungsi helper baharu atau mengubah lajur pangkalan data yang hanya wujud dalam commit terdahulu di develop, membawanya seorang diri ke main akan menyebabkan ralat kompilasi atau kegagalan runtime. Jika ia benar-benar terasing dan selamat, barulah mulakan proses pada branch baharu daripada main:

git switch main
git pull origin main
git switch -c hotfix/sst-rounding
git cherry-pick -x a1b2c3d

Flag -x sangat digalakkan untuk kerja berpasukan kerana Git akan menambah nota (cherry picked from commit a1b2c3d...) secara automatik di bahagian bawah mesej commit. Apabila ada pembangun lain menyemak sejarah main enam bulan kemudian, mereka tahu dengan tepat dari mana asal usul perubahan tersebut.

Mengurus konflik tanpa meneka

Jika fail yang sama di main sudah berubah berbeza daripada develop, git cherry-pick akan berhenti dan meminta anda menyelesaikan konflik secara manual. Jangan sesekali memilih accept current atau accept incoming tanpa membaca kedua-dua belah kod. Buka fail yang bertanda konflik, fahami konteks kod di main, kemudian jalankan ujian unit atau uji aliran berkaitan secara lokal sebelum meneruskan:

git add path/to/fixed-file.cs
git cherry-pick --continue

Jika ternyata konflik terlalu berselirat kerana commit itu berkait rapat dengan kod baharu lain di develop, hentikan sahaja proses dengan git cherry-pick --abort. Lebih selamat menulis pembetulan khusus yang bersih terus di atas branch hotfix daripada memaksa commit yang tidak serasi.

Mengelakkan sejarah berganda apabila branch bertemu

Perkara penting yang selalu dilupakan ialah cherry-pick menghasilkan commit baharu dengan nilai hash SHA yang berbeza daripada commit asal. Walaupun isi kodnya serupa, bagi Git kedua-duanya ialah dua sejarah yang berlainan. Apabila develop akhirnya digabung ke main beberapa minggu kemudian, Git kadang-kadang masih boleh mengesan perubahan yang sama jika tiada baris berdekatan yang berubah, namun jika fail tersebut disentuh lagi di develop, konflik yang mengelirukan boleh muncul.

Atas sebab itu, rancang dari awal bagaimana kedua-dua aliran kod akan diselaraskan:

  • Jika pembetulan belum ditulis di mana-mana, lebih bersih membuka branch hotfix terus daripada main, siapkan pembetulan dan ujiannya di situ, deploy ke produksi, kemudian merge semula branch hotfix tersebut ke dalam develop. Cara ini mengekalkan hash commit yang sama pada kedua-dua branch.
  • Jika pembetulan sudah terlanjur berada di develop dan terpaksa di-cherry-pick ke main, catat rujukan silang dalam Pull Request dan sahkan selepas deploy bahawa tiada perubahan susulan di develop yang tertinggal atau bertindih.

Git hanyalah alat yang memindahkan baris kod, bukan niat di sebaliknya. Sebelum menaip arahan cherry-pick, pastikan anda boleh terangkan dalam satu ayat mengapa perubahan itu perlu naik sekarang dan apakah kesannya apabila branch pembangunan digabung semula nanti.