Clean Code: Kebiasaan Kecil yang Membuat Kodemu Mudah Dirawat

Kamu membuka kode lama, mungkin tulisanmu sendiri beberapa bulan lalu, dan tetap tidak paham maksudnya. Clean Code karya Robert C. Martin, yang akrab disapa Uncle Bob, membahas cara menulis kode yang mudah dibaca, dipahami, dan dirawat, agar pengalaman seperti itu tidak terus berulang.

Pesan intinya tegas: menulis kode bersih adalah tanggung jawab seorang profesional. Kualitas itu tidak lahir dari satu keputusan besar, melainkan dari detail kecil yang dijaga setiap hari. Berikut pelajaran utamanya.

Kode berantakan itu mahal

Kode yang ditulis terburu-buru demi tenggat sering terasa menghemat waktu. Namun, kekacauan itu menumpuk. Setiap perubahan baru menjadi lebih sulit, bug makin sering muncul, dan produktivitas tim terus merosot.

Kalimat “nanti saja dirapikan” jarang benar-benar ditepati. Martin mengingatkan bahwa cara untuk tetap bekerja cepat adalah menjaga kode bersih setiap saat. Ia juga mengajak programmer mengikuti semangat aturan pramuka: tinggalkan kode sedikit lebih bersih daripada saat kamu menemukannya.

Martin juga mengajak programmer tidak sekadar menyalahkan manajer atau tenggat. Sebagai profesional, programmer punya tanggung jawab membela kualitas kode, sama seperti dokter yang tetap mencuci tangan meski pasien memintanya terburu-buru.

Beri nama yang jujur

Nama variabel, fungsi, dan kelas adalah bagian kode yang paling sering kamu baca. Karena itu, nama harus menjelaskan maksudnya tanpa perlu ditebak.

• Pilih nama yang mengungkapkan tujuan, misalnya jumlahHariSejakDaftar alih-alih d.
• Hindari nama yang menyesatkan atau terlalu mirip satu sama lain.
• Gunakan nama yang bisa diucapkan dan mudah dicari.
• Konsisten: satu konsep, satu kata.

Waktu yang kamu habiskan untuk memilih nama yang baik akan terbayar setiap kali kode itu dibaca, baik olehmu maupun rekan setim.

Nama yang baik juga mengurangi kebutuhan akan komentar, karena kode sudah bercerita dengan sendirinya.

Fungsi kecil yang melakukan satu hal

Menurut Martin, fungsi seharusnya kecil, bahkan lebih kecil dari yang biasa kita bayangkan. Setiap fungsi sebaiknya hanya melakukan satu hal, melakukannya dengan baik, dan tidak melakukan hal lain.

Fungsi yang kecil lebih mudah diberi nama, diuji, dan dipahami. Ia juga sebaiknya punya sedikit argumen dan tidak menimbulkan efek samping tersembunyi. Kalau kamu kesulitan memberi nama sebuah fungsi, itu tanda fungsinya melakukan terlalu banyak hal.

Isi satu fungsi juga sebaiknya berada pada tingkat abstraksi yang sama. Mencampur logika tingkat tinggi dengan detail teknis kecil di satu tempat membuat pembaca harus terus berpindah cara berpikir.

Komentar secukupnya, kode yang menjelaskan dirinya

Komentar sering dianggap tanda kode yang baik. Martin justru melihatnya sebaliknya: komentar kerap menjadi upaya menutupi kode yang sulit dipahami. Lebih baik menulis ulang kodenya agar jelas daripada menjelaskannya lewat komentar.

Komentar juga bisa basi. Kode berubah, tetapi komentar sering tertinggal dan akhirnya menyesatkan. Tetap ada komentar yang berguna, misalnya penjelasan maksud di balik keputusan yang tidak terlihat dari kode, tetapi gunakan secukupnya.

Satu kebiasaan lagi yang perlu ditinggalkan: kode yang dimatikan lewat komentar. Hapus saja, karena sistem kontrol versi sudah menyimpan riwayatnya.

Tes, kelas kecil, dan refactoring bertahap

Kode bersih butuh jaring pengaman. Tes otomatis membuatmu berani mengubah dan merapikan kode, karena kamu langsung tahu jika ada yang rusak. Martin menekankan bahwa kode tes pun harus dijaga sebersih kode produksi.

Prinsip yang sama berlaku untuk kelas: buat kelas yang kecil dengan satu tanggung jawab yang jelas. Kelas yang mengurus terlalu banyak hal akan sulit diubah tanpa merusak bagian lain.

Penanganan kesalahan juga mendapat perhatian khusus. Martin menyarankan memakai exception alih-alih kode galat, dan menghindari mengembalikan nilai null yang memaksa setiap pemanggil melakukan pemeriksaan tambahan.

Buku ini juga memuat studi kasus refactoring nyata dan daftar bau kode (code smell) yang perlu kamu waspadai, seperti duplikasi, fungsi yang terlalu panjang, dan nama yang membingungkan. Refactoring dilakukan sedikit demi sedikit, dengan tes dijalankan di setiap langkah.

Merapikan kode bukan pekerjaan satu kali. Kode bersih adalah hasil dari kebiasaan kecil yang diulang terus-menerus.

Untuk tim pengembang di startup maupun perusahaan besar, kebiasaan ini bisa dimulai dari hal sederhana: sepakati standar penamaan, sisihkan waktu merapikan kode di setiap tugas, dan jadikan tinjauan kode sebagai ajang belajar bersama.

Jadikan kode bersih sebagai kebiasaan

Clean Code mengajarkan bahwa kode yang baik adalah bentuk kepedulian pada rekan kerja dan dirimu di masa depan. Untuk prinsip, contoh, dan studi kasus lengkap dari Robert C. Martin, baca ringkasan lengkap “Clean Code” di aplikasi BacaApps.

Baca ringkasan lengkapnya di BacaApps: Clean Code karya Robert C. Martin