Meja kerja pembangun dengan Git dan keselamatan akaun

Ada hari kita menukar warna butang, membaiki pengesahan borang dan mengemas teks footer dalam satu sesi pagi sebelum makan tengah hari. Semuanya terasa seperti satu kerja kerana dibuat dalam satu aliran. Tetapi apabila ketiga-tiga perkara itu masuk ke dalam satu commit bernama update website, kita sebenarnya sedang meninggalkan teka-teki untuk diri sendiri pada minggu depan.

Masalahnya jarang muncul pada hari yang sama. Ia muncul beberapa hari kemudian apabila klien telefon beritahu borang hubungi tidak hantar e-mel, atau susun atur mudah alih lari di satu halaman. Bila kita buka git log --oneline -n 10 dan nampak lima commit berturut-turut bertajuk fix, update, wip dan minor changes, kerja mencari punca terus bertukar menjadi kerja meneka.

Satu perubahan, satu alasan

Commit yang baik tidak semestinya menyentuh satu fail sahaja. Ia boleh menyentuh lima fail asalkan semuanya menjawab satu tujuan yang sama, misalnya membaiki pengesahan borang hubungi. Kod JavaScript, teks ralat dalam template, dan pelarasan CSS untuk mesej ralat boleh bergerak bersama kerana pengguna mengalami semuanya sebagai satu pembetulan. Sebaliknya, gambar profil baharu atau kemas kini pautan media sosial di footer patut duduk dalam commit berasingan.

Sebelum menaip git commit, biasakan diri menjalankan git diff dan bertanya satu soalan mudah: jika perubahan ini terpaksa dibatalkan esok, adakah saya mahu membatalkan semuanya serentak? Jika jawapannya tidak, pecahkan kerja itu sebelum ia masuk ke sejarah projek.

Apabila dua perubahan sudah pun bercampur dalam fail yang sama, git add -p sangat membantu. Git akan memaparkan setiap blok perubahan (hunk) satu demi satu dan membolehkan kita memilih y untuk stage, n untuk langkau, atau s untuk pecahkan blok yang terlalu besar. Dengan cara ini, pembaikan pepijat boleh di-commit dahulu manakala pengemasan kod atau perubahan teks menunggu di working tree untuk commit seterusnya.

Elakkan git add . secara membuta tuli

Tabiat paling cepat merosakkan sejarah repo ialah menjalankan git add . tanpa menyemak git status terlebih dahulu. Dalam projek web harian, terlalu mudah untuk fail sementara terselit: tangkapan skrin ujian, fail .env tempatan, appsettings.Development.json, atau folder dist/ yang sepatutnya diabaikan.

Menjalankan git status dan git diff --staged mengambil masa kurang daripada sepuluh saat. Semakan ringkas ini juga sering menyelamatkan kita daripada membuang masa memadam fail sensitif daripada sejarah Git kemudian hari, yang jauh lebih leceh berbanding menyemak sebelum commit.

Tulis mesej yang menerangkan sebab

Mesej Fix contact form validation jauh lebih berguna daripada fix. Jika sebabnya tidak jelas daripada tajuk sahaja, tambahkan satu atau dua ayat dalam isi mesej commit untuk menerangkan konteksnya—contohnya mengapa had panjang medan diubah atau mengapa semakan tertentu ditambah. Kita tidak perlu menulis karangan panjang; cukup sekadar membolehkan diri kita sendiri enam bulan lagi faham tanpa perlu membaca setiap baris kod.

Bayangkan situasi di mana rakan sepasukan perlu membatalkan pembetulan borang dengan git revert <sha>, tetapi mahu mengekalkan kemas kini footer dan jadual harga. Jika dua kerja itu berada dalam commit berasingan, satu arahan git revert sudah memadai. Jika semuanya bercampur dalam satu commit besar, seseorang terpaksa menyunting semula fail secara manual dalam keadaan tergesa-gesa sebelum deploy.

Begitu juga bila menggunakan git bisect untuk mencari commit mana yang merosakkan build atau fungsi tertentu. Jika setiap commit adalah unit kerja yang lengkap dan boleh dibina tanpa ralat, git bisect akan terus menunjuk kepada commit yang tepat. Jika sejarah penuh dengan commit separuh siap yang gagal compile, proses mencari pepijat akan tersangkut di tengah jalan.

Jangan terlalu taksub hingga jadi terlalu halus

Commit kecil tidak bermakna setiap koma atau baris CSS perlu dijadikan satu commit berasingan. Lima commit berturut-turut bertajuk fix typo, fix spacing, remove console.log dalam pull request yang sama hanya memenuhkan log tanpa menambah nilai.

Jika kesilapan kecil itu belum di-push ke branch kongsi, gunakan git commit --amend --no-edit selepas git add untuk menggabungkannya ke dalam commit terakhir. Sebaik sahaja kerja sudah di-push dan disemak orang lain, biarkan sejarah itu kekal bersih dengan commit baharu yang jelas, daripada menulis semula sejarah branch yang sudah dikongsi.

Amalan ini memang terasa sedikit perlahan pada minggu pertama. Namun ia membayar balik masa berkali ganda semasa code review, ketika menyiasat regresi di production, dan sewaktu perlu kembali kepada versi yang stabil dengan yakin. Panduan GitHub tentang commit dan branch menerangkan aliran asas ini dengan baik sebagai rujukan tambahan.