
Bayangkan situasi ini: anda baru perasan fungsi penapis carian invois atau pengiraan diskaun di laman web tiba-tiba tidak menjadi. Anda yakin sepenuhnya ciri itu masih berfungsi dengan baik pada awal bulan lepas, tetapi di antara tarikh itu dengan hari ini, pasukan anda sudah menggabungkan lebih 60 commit berbeza ke dalam cabang main.
Membaca setiap commit satu demi satu melalui git log atau menyemak setiap Pull Request secara manual sangat memenatkan dan memakan masa berjam-jam. Untuk masalah seperti inilah git bisect dicipta. Ia menggunakan algoritma carian binari (binary search) untuk mengecilkan 64 commit kepada satu commit punca dalam hanya enam langkah semakan sahaja.
Aliran kerja asas git bisect dalam beberapa minit
Untuk memulakan git bisect, anda cuma perlukan dua titik rujukan dalam sejarah Git: satu commit yang diketahui rosak (biasanya HEAD sekarang), dan satu commit atau Git tag lama yang anda pasti masih elok.
git bisect start
git bisect bad HEAD
git bisect good v1.3.0
Sebaik sahaja anda memasukkan arahan tersebut, Git akan melompat terus ke commit di titik tengah di antara v1.3.0 dan HEAD. Anda jalankan aplikasi seperti biasa, uji ciri yang bermasalah itu, dan beritahu Git keputusannya:
- Jika pepijat masih berlaku, taip
git bisect bad - Jika ciri berfungsi dengan elok, taip
git bisect good - Jika commit di titik tengah itu kebetulan gagal dibina kerana isu lain yang tidak berkaitan, taip
git bisect skip
Setiap kali anda memberi jawapan, Git akan membuang separuh daripada ruang carian dan melompat ke titik tengah baharu. Selepas beberapa pusingan, Git akan berhenti dan memaparkan mesej seperti <hash> is the first bad commit berserta nama pengarang dan tarikh perubahan tersebut.
Automatikkan ujian dengan git bisect run
Jika anda mempunyai skrip ujian automatik atau boleh menulis satu skrip ringkas untuk menyemak pepijat tersebut, anda tidak perlu menguji setiap langkah secara manual. Cukup berikan arahan ujian kepada git bisect run:
git bisect start HEAD v1.3.0
git bisect run npm test -- --grep="kiraan diskaun"
Untuk projek .NET pula, anda boleh menyasarkan ujian unit tertentu sahaja supaya setiap pusingan berjalan pantas:
git bisect run dotnet test --filter "FullyQualifiedName~DiscountCalculatorTests"
Git akan mengendalikan semua langkah secara automatik berdasarkan kod keluar (exit code) skrip tersebut: 0 dianggap good, kod antara 1 hingga 127 (kecuali 125) dianggap bad, dan kod 125 memberi isyarat kepada Git untuk melangkau (skip) commit tersebut jika ia gagal dikompilasi. Anda boleh tinggalkan terminal beberapa minit dan biarkan Git mencari puncanya sendiri.
Perangkap yang sering membuatkan git bisect tersasar
Walaupun nampak mudah, hasil git bisect boleh mengelirukan jika dua perkara ini tidak dijaga:
- Kriteria ujian yang kabur: Soalan seperti “rasa macam halaman ni lambat sikit” sukar dinilai secara konsisten pada setiap langkah. Tukar kepada ujian objektif Ya atau Tidak, contohnya “panggilan API
/api/invoices?status=paidmemulangkan 3 rekod dan bukannya 0”. - Sisa persekitaran daripada commit terkini: Apabila Git berpatah balik ke commit tiga minggu lalu, fail binaan lama (
bin/,obj/,.next/), pakejnode_modules, atau skema migrasi pangkalan data yang sudah dikemas kini mungkin masih tertinggal dalam folder kerja anda. Bersihkan cache atau jalankan semula pemasangan pakej jika struktur fail berubah dengan ketara antara versi.
Jangan lupa git bisect reset selepas selesai
Setelah anda menemui commit sasaran, pastikan anda keluar daripada mod bisect dengan menaip:
git bisect reset
Arahan ini akan mengembalikan repositori anda ke cabang asal dengan bersih. Ramai pembangun terlupa langkah ini lalu terus membuat perubahan dalam keadaan detached HEAD.
Akhir sekali, apabila git bisect menunjukkan satu commit tertentu, jangan anggap tujuan alat ini adalah untuk mencari siapa yang patut dipersalahkan. Kerap kali perubahan yang sah di satu modul cuma mendedahkan andaian rapuh yang sudah lama tersembunyi di tempat lain. Baca perubahan tersebut dengan git show <hash>, fahami punca sebenar, baiki masalahnya, dan tambah satu ujian regresi supaya pepijat yang sama tidak kembali pada masa hadapan.