Git sebagai alat berpikir
Git bukan sekadar cadangan atau cara berbagi kode. Kalau dipakai dengan baik, Git membuat Anda bekerja dalam langkah-langkah kecil yang jelas: satu gagasan per commit, diff yang dibaca sebelum commit, pesan yang menjelaskan alasan, branch untuk eksperimen, dan cara membatalkan yang aman.
“Version control is a system that records changes to a file or set of files over time so that you can recall specific versions later.” Itu definisi dari buku Pro Git: sistem yang mencatat perubahan file dari waktu ke waktu supaya versi tertentu bisa dipanggil kembali. Memang benar. Kebanyakan orang belajar Git dengan cara itu: sebagai cadangan, atau tempat push supaya rekan tim bisa pull.
Tapi beberapa bagian terakhir sudah memakai Git untuk lebih dari itu. Di bagian 12, git blame menjelaskan kenapa sebuah baris aneh ada. Di bagian 15, git bisect menemukan commit yang merusak diskon. Keduanya hanya berhasil karena seseorang, sebelumnya, membuat commit kecil dengan pesan yang berguna. Bagian ini tentang menjadi orang itu, dan bagaimana kebiasaan itu mengubah cara Anda bekerja.
Satu commit, satu gagasan
Situasi yang umum: Anda sedang mengerjakan pricing.py dan sudah membuat dua perubahan, yaitu diskon baru 10% untuk 20+ barang, dan pemisah ribuan di format_rupiah. git diff menampilkan keduanya:
@@ -1,6 +1,8 @@
def final_price(price, qty):
total = price * qty
- if qty >= 10:
+ if qty >= 20:
+ total = total * 90 // 100
+ elif qty >= 10:
total = total * 95 // 100
return max(total, 0)
@@ -14,4 +16,4 @@ def tax(amount):
def format_rupiah(amount):
- return "Rp" + str(amount)
+ return "Rp" + f"{amount:,}".replace(",", ".")
Jalan pintasnya git commit -am "update pricing". Tapi ini dua gagasan yang terpisah. Kalau diskon baru ternyata salah, Anda ingin membatalkannya tanpa kehilangan perbaikan format. Kalau tahun depan seseorang menjalankan git blame di baris diskon, ia seharusnya mendarat di commit tentang diskon.
git add -p membuat Anda bisa memilih bagian mana yang masuk ke commit berikutnya. Perintah ini akan “Interactively choose hunks of patch between the index and the work tree and add them to the index”, dan “gives the user a chance to review the difference before adding modified contents to the index”: Anda memilih potongan perubahan satu per satu, sekaligus meninjau perbedaannya sebelum dimasukkan. Git menampilkan setiap potongan (hunk) dan bertanya:
(1/2) Stage this hunk [y,n,q,a,d,j,J,g,/,e,?]? n
(2/2) Stage this hunk [y,n,q,a,d,K,g,/,e,?]? y
Jawab n untuk diskon dan y untuk format, maka hanya perubahan format yang disiapkan:
$ git diff --staged
- return "Rp" + str(amount)
+ return "Rp" + f"{amount:,}".replace(",", ".")
Commit itu, lalu commit sisanya. Dua commit, masing-masing tentang satu hal:
123227b Add 10% discount for 20+ items
cb2ed24 Show thousands separators in rupiah amounts
2a8c473 Add pricing helpers
Manfaat sebenarnya muncul sebelum semua ini: begitu Anda tahu akan meng-commit satu gagasan setiap kali, Anda mulai bekerja satu gagasan setiap kali. Selesaikan format, commit, lalu mulai diskon. Ini lagi-lagi dekomposisi dari bagian 9, dengan Git yang menjaga Anda tetap disiplin.
Baca diff Anda sendiri sebelum commit
git diff --staged menunjukkan persis apa yang akan di-commit. Membacanya adalah code review paling murah. Dalam beberapa detik itu, Anda sering menemukan:
printatauvar_dumpsisa debugging,- perubahan tidak sengaja di file yang tadinya hanya ingin dilihat,
- gagasan kedua yang seharusnya punya commit sendiri,
- password atau API key yang tidak boleh pernah di-commit (dibahas di bawah).
Kalau Anda tidak bisa merangkum diff yang disiapkan dalam satu baris pendek, kemungkinan itu dua commit.
Pesan commit: jelaskan kenapa
Kode menunjukkan apa yang berubah. Pesan commit satu-satunya tempat untuk menjelaskan kenapa. Chris Beams merumuskannya dengan baik: “A diff will tell you what changed, but only the commit message can properly tell you why.” Diff memberi tahu apa yang berubah, hanya pesan commit yang bisa menjelaskan alasannya.
Tujuh aturannya yang banyak dikutip:
- “Separate subject from body with a blank line” (pisahkan subjek dan isi dengan satu baris kosong)
- “Limit the subject line to 50 characters” (subjek maksimal 50 karakter)
- “Capitalize the subject line” (awali subjek dengan huruf kapital)
- “Do not end the subject line with a period” (jangan akhiri subjek dengan titik)
- “Use the imperative mood in the subject line” (subjek berbentuk perintah)
- “Wrap the body at 72 characters” (bungkus isi pada 72 karakter)
- “Use the body to explain what and why vs. how” (isi menjelaskan apa dan kenapa, bukan bagaimana)
Bentuk perintah punya ujian sederhana: subjek yang baik melengkapi kalimat “If applied, this commit will …” (kalau diterapkan, commit ini akan …). Add 10% discount for 20+ items cocok. Added stuff dan fix tidak.
Kalau alasannya tidak jelas dengan sendirinya, tambahkan isi:
Add 10% discount for 20+ items
Wholesale customers asked for a second tier. 10-19 items keep 5%.
Enam bulan kemudian, git blame di baris itu langsung membawa ke alasannya:
$ git blame -s -L 3,4 pricing.py
123227b4 3) if qty >= 20:
123227b4 4) total = total * 90 // 100
Bandingkan dengan perbaikan refund di bagian 12, saat pesan “Fix negative totals from refund rows (qty = -1) in CSV import” menjelaskan baris yang kalau tidak begitu terlihat tak berguna. Pesan seperti itulah yang ingin Anda tulis.
Pesan commit di contoh ini berbahasa Inggris karena itu kebiasaan umum di proyek yang dibaca banyak orang. Di tim yang semuanya berbahasa Indonesia, pesan berbahasa Indonesia juga sah; yang penting konsisten dan menjelaskan alasan.
Commit kecil membuat riwayat berguna
Semua alat riwayat jadi lebih baik dengan commit kecil:
git blamemenunjuk ke commit tentang satu hal, bukan “perubahan macam-macam”.git bisect(bagian 15) menemukan commit kecil, jadi bug-nya ada di beberapa baris, bukan ratusan.git revertbisa membatalkan satu gagasan dengan bersih.- Code review lebih cepat kalau setiap commit bisa dibaca sendiri-sendiri.
Kecil bukan berarti sangat kecil. Artinya satu perubahan yang utuh, idealnya yang tetap membuat tes dari bagian 14 lulus.
Branch itu murah, jadi bereksperimenlah
Tidak yakin sebuah gagasan akan berhasil? Coba di branch. Pro Git menjelaskan kenapa itu bukan masalah besar: “The way Git branches is incredibly lightweight, making branching operations nearly instantaneous”, dan “branches are cheap to create and destroy.” Branch di Git sangat ringan, hampir instan dibuat, dan murah untuk dibuat maupun dihapus.
$ git switch -c try-round-to-hundreds
$ # edit, test, commit...
$ git log --oneline -1
d695d2e Try rounding totals down to hundreds
$ git switch main
$ git branch -D try-round-to-hundreds
Deleted branch try-round-to-hundreds (was d695d2e).
Eksperimennya hilang dan main tidak pernah tersentuh. Kalau eksperimennya berhasil, Anda tinggal merge. Apa pun hasilnya, Anda bisa mencoba hal yang berisiko tanpa khawatir sulit kembali ke kondisi yang berjalan.
Membatalkan dengan aman
Salah itu biasa. Pertanyaannya, bagaimana membatalkannya tanpa memperburuk keadaan.
git revert membatalkan sebuah commit dengan menambahkan commit baru yang membalikkannya. Dokumentasinya: “git revert is used to record some new commits to reverse the effect of some earlier commits (often only a faulty one).” Misalkan pemisah ribuan ternyata merusak laporan yang mengharapkan angka polos:
$ git revert --no-edit HEAD~1
[main 6ea0a5a] Revert "Show thousands separators in rupiah amounts"
$ git log --oneline
6ea0a5a Revert "Show thousands separators in rupiah amounts"
123227b Add 10% discount for 20+ items
cb2ed24 Show thousands separators in rupiah amounts
2a8c473 Add pricing helpers
Perubahan format dibatalkan, commit diskon sesudahnya tetap utuh, dan riwayatnya mencatat apa yang terjadi dan kapan. Ini pilihan aman untuk apa pun yang sudah di-push dan dipakai bersama.
git reset memundurkan branch dan bisa membuang perubahan. Berguna untuk pekerjaan sendiri yang belum di-push, tapi git reset --hard membuang perubahan yang belum di-commit. Dokumentasi git revert, saat merujuknya sebagai alternatif, memperingatkan: “Take care with these alternatives as both will discard uncommitted changes in your working directory.” Kalau ragu, commit atau buat branch dulu. Commit hampir selalu bisa dipulihkan; pekerjaan yang belum di-commit lalu ter-reset biasanya tidak.
Jauhkan rahasia dan sampah
“A gitignore file specifies intentionally untracked files that Git should ignore”: file .gitignore berisi daftar file yang sengaja tidak dilacak. Masukkan file hasil generate, dependensi, dan rahasia lokal ke sana:
.env
__pycache__/
$ git check-ignore -v .env
.gitignore:1:.env .env
Ada satu jebakan yang perlu diketahui: “Files already tracked by Git are not affected.” File yang sudah dilacak tidak terpengaruh. Kalau .env sudah ter-commit sebelum dimasukkan ke .gitignore, file itu tetap ada di repository dan di riwayatnya. Hentikan pelacakannya dengan git rm --cached .env, dan anggap rahasia apa pun yang pernah ter-commit sudah bocor: ganti password atau key-nya. Bagian 22 akan kembali ke sini.
Putarannya
Kalau digabungkan, Git memberi Anda ritme:
- Pilih satu perubahan kecil.
- Kerjakan, lalu jalankan tes.
- Baca diff-nya.
- Commit dengan pesan yang menjelaskan alasannya.
- Ulangi.
Kalau bekerja seperti ini, Anda tidak pernah jauh dari kondisi yang berjalan, selalu tahu apa yang sudah diubah, dan riwayatnya menjadi catatan penalaran Anda yang bisa dicari lagi nanti, oleh Anda maupun orang lain.
Kenapa ini penting sehari-hari
- Lebih sedikit rasa takut. Kalau setiap langkah sudah di-commit, eksperimen apa pun bisa dibatalkan dalam hitungan detik.
- Review dan debugging lebih cepat. Commit kecil dengan pesan jelas mudah di-review, di-bisect, dan di-revert.
- Jawaban untuk diri Anda di masa depan. “Kenapa ini ada di sini?” hanya sejauh satu
git blame, asalkan pesannya menjelaskan alasan. - Bekerja dengan AI. Commit dulu sebelum membiarkan AI mengubah kode, lalu baca perubahannya dengan
git diffseperti diff lainnya. Kalau hasilnya tidak cocok, satu perintah membawa Anda kembali. Bagian 24 akan membahas review perubahan dari AI.
Coba sendiri
- Buat dua perubahan yang tidak berhubungan di satu file, lalu pakai
git add -puntuk meng-commit-nya terpisah. - Lihat sepuluh pesan commit terakhir Anda. Tulis ulang yang paling buruk supaya melengkapi “If applied, this commit will …” dan menjelaskan alasannya.
- Buat branch, coba sesuatu yang berisiko, lalu hapus branch-nya tanpa merge. Pastikan
maintidak berubah. - Revert salah satu commit Anda sendiri di repo latihan dan baca riwayat yang dihasilkan.
Ringkasan
- Git mencatat perubahan supaya Anda bisa memanggil kembali, menjelaskan, dan membatalkannya; kalau dipakai dengan baik, Git membentuk cara Anda bekerja.
- Satu commit, satu gagasan.
git add -pmemisahkan perubahan yang tercampur. - Baca
git diff --stagedsebelum setiap commit. - Pesan menjelaskan kenapa: subjek pendek berbentuk perintah, isi untuk alasannya.
- Commit kecil membuat blame, bisect, revert, dan review berguna.
- Branch itu murah: bereksperimenlah, hapus yang tidak berhasil.
git revertmembatalkan dengan aman lewat commit baru; hati-hati dengangit reset..gitignoremenjauhkan sampah dan rahasia, tapi tidak memengaruhi file yang sudah dilacak.
Referensi
- Scott Chacon dan Ben Straub, Pro Git: About Version Control dan Branches in a Nutshell.
- git-add, git-revert, git-switch, dan gitignore, dokumentasi Git.
- Chris Beams, How to Write a Git Commit Message.