Pembangun menyusun sejarah kod Git

Banyak tutorial Git di internet mempamerkan graf sejarah commit yang lurus sempurna seperti rel kereta api. Kesannya, pembangun yang baru bekerja dalam pasukan sering berasa bersalah setiap kali melihat garisan bercabang daripada merge commit, lalu mula menjalankan git rebase di mana-mana sahaja tanpa memahami satu hakikat asas: git rebase menulis semula sejarah dengan mencipta hash commit yang baharu.

Selagi anda melakukannya pada branch peribadi yang hanya wujud di komputer anda sendiri, ia alat yang sangat kemas. Tetapi sebaik sahaja anda melakukan rebase ke atas branch yang sudah di-push dan sedang ditarik oleh rakan sepasukan lain, hash commit mereka tidak lagi sepadan dengan versi di pelayan. Dari situ mulalah drama konflik berganda, commit yang muncul dua kali dalam Pull Request, atau lebih teruk—kerja rakan terpadam tanpa sengaja kerana ada yang tergesa-gesa menjalankan git push --force.

Aliran kerja selamat pada feature branch sendiri

Apabila saya menyiapkan sesuatu ciri atau membaiki pepijat pada branch sendiri dan mahu menyelaraskannya dengan kemas kini terkini daripada main sebelum membuka Pull Request, ada beberapa langkah mudah yang mengelakkan panik.

Pertama, pastikan working tree bersih dengan git status—tiada perubahan tergantung yang belum di-commit atau di-stash—kemudian tarik rujukan terkini dari pelayan:

git fetch origin

Kedua, jika anda bakal melakukan rebase yang melibatkan banyak commit atau perubahan besar, buat satu branch sandaran sementara sebelum menyentuh apa-apa:

git branch backup/sebelum-rebase

Langkah ini mengambil masa dua saat sahaja, tetapi ia memberi ketenangan fikiran yang besar. Walaupun git reflog sentiasa merekod pergerakan HEAD selama berminggu-minggu, mempunyai nama branch sementara jauh lebih pantas untuk kembali ke keadaan asal jika anda mahu membatalkan semuanya.

Selepas itu, barulah jalankan rebase ke atas origin/main:

git rebase origin/main

Jika Git berhenti dan melaporkan konflik, jangan gopoh. Selesaikan konflik pada fail yang ditanda, semak perubahan dengan git diff, tanda sebagai selesai dengan git add <fail>, dan teruskan dengan git rebase --continue. Kalau di tengah jalan anda sedar penyelesaian konflik itu mula bercelaru dan mahu bermula semula, git rebase --abort akan memulangkan branch anda ke keadaan asal sebelum arahan dijalankan.

Satu kesilapan klasik selepas konflik berjaya diselesaikan ialah terus menolak kod ke GitHub tanpa menguji semula. Git hanya tahu baris teks tidak lagi bertindih; ia tidak tahu sama ada dua perubahan daripada orang berbeza telah merosakkan logik fungsi atau membuang satu panggilan API penting. Jalankan semula dotnet test, npm run build, atau suite ujian projek anda selepas rebase selesai.

Mengapa --force-with-lease jauh lebih selamat daripada --force

Jika feature branch peribadi anda sudah pernah di-push ke pelayan—contohnya untuk mencetuskan binaan pratonton di Cloudflare Pages atau GitHub Actions—anda memang perlu membuat force push selepas rebase kerana sejarah commit telah berubah.

Namun elakkan menaip git push --force. Gunakan pilihan yang lebih berdisiplin:

git push --force-with-lease

Perbezaannya ketara: --force akan menimpa branch di pelayan secara membuta tuli tidak kira apa yang ada di sana. Sebaliknya, --force-with-lease memeriksa sama ada rujukan di pelayan masih sama seperti kali terakhir anda menjalankan git fetch. Jika rakan sepasukan ada menolak commit baharu ke branch tersebut yang belum anda tarik, Git akan menolak push anda dan menyelamatkan kerja rakan daripada hilang begitu sahaja.

Kalau mahu merapikan beberapa commit kecil seperti "wip", "betulkan typo", dan "test lagi" menjadi satu atau dua commit bermakna sebelum semakan kod, anda juga boleh menggunakan interactive rebase secara lokal:

git rebase -i origin/main

Tetapi sekali lagi, pastikan branch itu memang milik anda seorang.

Sejarah lurus bukan matlamat utama sebuah pasukan

Tidak ada satu aliran Git yang wajib diguna pakai oleh semua pasukan. Dalam sesetengah projek yang laju, pasukan memilih Squash and Merge terus di GitHub atau GitLab pada setiap Pull Request. Dengan cara itu, branch main tetap kekal bersih dengan satu commit bagi setiap ciri, tanpa memaksa setiap pembangun melakukan rebase manual setiap hari. Pasukan lain pula lebih selesa mengekalkan merge commit supaya sejarah bila dan bagaimana sesuatu ciri digabungkan kekal jelas.

Apa pun konvensyen yang dipilih, tuliskan peraturannya dengan jelas di CONTRIBUTING.md atau dokumentasi dalaman supaya pembangun baharu tidak perlu meneka. Sejarah Git wujud untuk memudahkan kita mencari punca pepijat enam bulan akan datang menggunakan git bisect dan git log, bukan untuk memenangi pertandingan melukis graf paling lurus.