Masa belajar dulu, asalkan kod tu tak keluar error dan output betul, kita dah rasa cukup bersyukur. Tapi bila masuk alam pekerjaan, mindset tu kena ubah 180 darjah. Kod yang korang tulis hari ni, mungkin akan dibaca dan diselenggara oleh developer lain 6 bulan dari sekarang.
Kalau kod korang berterabur, memang menempah maut masa sesi code review (PR). Jom semak 5 kesilapan biasa fresh grad dan macam mana nak tulis kod yang lebih “bersih” atau clean code.
1. Nama Variable Yang Main Hentam (A, B, X, Y)
Ini dosa paling besar. Jangan guna nama variable yang pendek dan tak ada makna. Nanti korang sendiri lupa apa fungsi variable tu.
Buruk: let d = 5; // d tu apa? days? distance?
Bagus (Clean Code): let daysUntilExpiry = 5;
2. ‘Magic Numbers’ Merata-rata
Magic numbers merujuk kepada nombor yang tiba-tiba muncul dalam logik kod tanpa sebarang konteks atau penjelasan.
Buruk: if (userAge > 21) { … }
Bagus (Clean Code): const LEGAL_DRINKING_AGE = 21; if (userAge > LEGAL_DRINKING_AGE) { … }
3. Tinggalkan ‘Zombie Code’
Pernah tak korang comment out berpuluh baris kod sebab takut nak padam? Dalam industri, kita ada Git. Kalau korang padam dan perlukan kod tu balik, korang boleh cari dalam commit history. Jangan biarkan fail penuh dengan commented code yang berselirat.
4. Fungsi Yang Terlalu Panjang
Satu fungsi (function) sepatutnya buat satu kerja sahaja. Kalau fungsi korang sampai 200 baris sebab dia buat validation, panggil API, dan kemas kini database serentak, pecahkan ia kepada beberapa fungsi kecil.
Finish with a Takeaway
Menulis clean code bukannya tentang tunjuk pandai guna syntax yang rumit. Ia adalah tentang sifat empati—menulis kod seolah-olah orang yang akan maintain kod tu nanti adalah seorang psychopath yang tahu alamat rumah korang. Sentiasa utamakan kod yang mudah dibaca (readability) berbanding kod yang terlalu ringkas tapi susah difahami.