Tips Menulis Kode yang Mudah Dipelihara

Menulis kode yang mudah dipelihara bukan soal seberapa pintar solusinya, tapi seberapa mudah orang lain (atau diri sendiri di masa depan) memahami dan mengubahnya. Berikut beberapa kebiasaan yang saya terapkan.

1. Beri nama yang jelas

Nama variabel dan fungsi adalah dokumentasi paling murah. isRegisteredForDiscounts jauh lebih jelas daripada flag2. Kalau butuh komentar untuk menjelaskan nama, biasanya namanya yang perlu diperbaiki.

2. Satu fungsi, satu tugas

Fungsi yang panjang dan mengerjakan banyak hal sulit diuji dan sulit diubah. Pecah menjadi fungsi kecil yang masing-masing punya satu tanggung jawab. Ini sejalan dengan prinsip Single Responsibility dari SOLID.

3. Hindari duplikasi, tapi jangan berlebihan

Kode yang sama di tiga tempat memang layak dirapikan. Namun jangan terburu-buru membuat abstraksi untuk dua potongan kode yang kebetulan mirip. Abstraksi yang salah lebih mahal daripada sedikit duplikasi.

4. Tulis tes untuk perilaku penting

Tes bukan untuk mengejar angka coverage, melainkan agar kamu berani mengubah kode tanpa takut merusak fitur lain. Fokuskan pada logika bisnis dan kasus gagal yang paling mungkin terjadi.

5. Review kode sendiri sebelum dikirim

Baca ulang diff sebelum membuat pull request. Hampir selalu ada nama yang kurang pas, sisa debug, atau potongan kode yang tidak terpakai.

Ringkasan

• Nama yang jelas mengalahkan komentar panjang.
• Fungsi kecil lebih mudah diuji.
• Abstraksi dibuat saat polanya sudah terbukti.
• Tes melindungi perilaku yang penting.