Code Complete (2nd Edition): Pelajaran Menulis Kode yang Rapi

Pernahkah kamu membuka kode yang kamu tulis sendiri enam bulan lalu, lalu merasa asing dengannya? Code Complete (2nd Edition) karya Steve McConnell ditulis untuk mencegah pengalaman seperti itu. Buku setebal sekitar 850 halaman ini berfokus pada konstruksi perangkat lunak, yaitu pekerjaan sehari-hari menulis, menguji, dan memperbaiki kode.

McConnell menjembatani riset akademis dengan praktik di lapangan, lengkap dengan sekitar 500 contoh kode dan checklist siap pakai. Berikut pelajaran utama yang bisa langsung kamu bawa ke proyekmu berikutnya.

Tugas utama programmer: mengelola kompleksitas

McConnell menempatkan pengelolaan kompleksitas sebagai tantangan teknis terpenting dalam pengembangan perangkat lunak. Otak manusia terbatas; tidak ada yang bisa memikirkan seluruh program besar sekaligus.

Karena itu, kode yang baik dirancang agar kamu cukup memikirkan satu bagian kecil pada satu waktu. Kelas dan rutin yang baik menyembunyikan detail rumit di baliknya, sehingga bagian lain cukup tahu apa yang dikerjakan, bukan bagaimana caranya.

Kode yang rumit bukan tanda kepintaran. Programmer yang baik justru berusaha membuat masalah yang sulit terlihat sederhana, sehingga mudah dipahami orang lain.

Pertanyaan sederhana untuk menguji desainmu: bisakah rekan setim memahami fungsi ini tanpa harus membaca seluruh isi berkas lain?

Persiapan menentukan biaya proyek

Banyak tim ingin langsung menulis kode. McConnell mengingatkan bahwa persiapan seperti memahami persyaratan dan merancang arsitektur sangat menentukan keberhasilan proyek.

Alasannya, kesalahan yang terlambat ditemukan jauh lebih mahal untuk diperbaiki. Salah memahami kebutuhan pengguna di awal bisa berarti membongkar banyak kode di akhir.

McConnell sering memakai perumpamaan membangun rumah. Mengubah denah di atas kertas jauh lebih murah daripada membongkar dinding yang sudah berdiri. Begitu pula perangkat lunak: semakin awal kesalahan ditemukan, semakin murah perbaikannya.

Ini tidak berarti semua hal harus dirancang sempurna sebelum mulai. Yang penting, kamu tahu cukup banyak tentang apa yang akan dibangun dan mengapa, sesuai dengan jenis proyekmu.

Proyek kecil yang dikerjakan sendiri tentu tidak butuh dokumen setebal proyek perbankan. Namun keduanya tetap butuh kejelasan tentang apa yang dibangun.

Nama dan struktur yang mudah dibaca

Kode lebih sering dibaca daripada ditulis. Karena itu McConnell memberi perhatian besar pada hal-hal yang sering dianggap sepele:

• Nama variabel dan rutin harus menjelaskan maksudnya. Nama seperti totalTagihan jauh lebih jelas daripada x atau temp.
• Rutin sebaiknya mengerjakan satu hal dengan baik, sehingga mudah diuji dan dipakai ulang.
• Struktur kontrol yang sederhana, misalnya menghindari percabangan bersarang terlalu dalam.
• Tata letak yang konsisten, karena indentasi dan spasi membantu mata memahami logika program.

Bayangkan rekan kerjamu harus memperbaiki bug di kodemu pada jam dua pagi. Nama yang jelas dan struktur yang rapi adalah bentuk kepedulian kepadanya, dan kepada dirimu sendiri di masa depan.

McConnell juga membahas pemrograman defensif, yaitu menulis kode yang siap menghadapi masukan tak terduga. Periksa data dari luar sebelum dipakai, dan putuskan sejak awal bagaimana program akan menangani kesalahan.

Memburu bug dengan metode ilmiah

Saat menghadapi bug, banyak programmer menebak-nebak dan mengubah kode secara acak sampai masalah tampak hilang. McConnell menyarankan pendekatan yang lebih disiplin, mirip metode ilmiah.

1. Kumpulkan data dengan memastikan bug bisa diulang secara konsisten.
2. Susun hipotesis tentang penyebabnya.
3. Rancang pengujian untuk membuktikan atau menyangkal hipotesis itu.
4. Perbaiki penyebabnya, lalu uji kembali perbaikanmu.
5. Cari kesalahan serupa di bagian lain.

Pendekatan ini terasa lebih lambat di awal, tetapi jauh lebih cepat daripada berjam-jam menebak. Yang terpenting, kamu memahami akar masalah, bukan sekadar menambal gejalanya.

Satu kebiasaan kecil yang membantu: periksa perubahan terbaru. Bug yang baru muncul sering berkaitan dengan kode yang baru saja diubah, sehingga melihat perubahan terakhir bisa mempersempit pencarian.

Kualitas dijaga bersama

Pengujian penting, tetapi McConnell menekankan bahwa pengujian saja tidak cukup untuk menemukan semua kesalahan. Inspeksi dan tinjauan kode oleh rekan setim adalah cara efektif lain untuk menangkap masalah lebih awal.

Ia juga membahas refactoring, yaitu memperbaiki struktur kode tanpa mengubah perilakunya. Refactoring yang dilakukan sedikit demi sedikit menjaga kode tetap sehat meski fitur terus bertambah.

Pesan pentingnya, kualitas bukan tahap terpisah di akhir proyek. Ia dibangun sedikit demi sedikit dalam setiap baris kode, setiap tinjauan, dan setiap pengujian sepanjang jalan.

Terakhir, McConnell menyinggung karakter programmer yang baik: rendah hati mengakui keterbatasan, rasa ingin tahu, dan kebiasaan terus belajar. Keterampilan teknis tumbuh dari sikap seperti ini.

Tulis kode yang lebih tangguh

Code Complete (2nd Edition) tetap menjadi salah satu buku yang paling sering direkomendasikan untuk programmer, dari pemula sampai senior. Ingin menelusuri pembahasannya tentang desain, variabel, kualitas, hingga karakter programmer? Baca ringkasan lengkap Code Complete (2nd Edition) di aplikasi BacaApps.

Baca ringkasan lengkapnya di BacaApps: Code Complete (2nd Edition) karya Steve McConnell