Temiz Kod Yazmak İçin 7 Pratik Kural

Yayınlayan: Saygın Elgün • Yazılım Kalitesi • 2025

İyi bir yazılımcıyla harika bir yazılımcı arasındaki fark her zaman “daha fazla teknoloji bilmek” değildir. Bazen tek fark, kodun okunabilirliğine gösterilen özen olabilir. Temiz kod, sadece bugünün değil geleceğin geliştiricilerine de saygı göstermektir — hatta bazen “gelecekteki kendinize” de!

1. Anlamlı Değişken ve Fonksiyon İsimleri Kullanın

data1 ya da temp gibi isimler kısa vadede iş görür ama uzun vadede zaman kaybettirir. Kod kendini açıklayabiliyorsa, yorum satırlarına daha az ihtiyaç duyarsınız.

2. Fonksiyonları Küçük Tutun

“Bir fonksiyon yalnızca tek bir iş yapmalıdır.” kuralı hâlâ geçerlidir. Bir fonksiyon 50 satırı geçmeye başladıysa, muhtemelen ikiye bölünmelidir.

3. Yorum Satırı Yazmak Yerine Kodu Anlaşılır Yazın

İyi kod kendini açıklar. Eğer bir kod bloğunun ne yaptığını açıklamak için yorum yazmak zorunda kalıyorsanız, önce kodu sadeleştirmeyi deneyin.

4. Magic Number ve String Kullanmaktan Kaçının

Koddaki 7 ya da \"XYZ\" sabitleri bir anda gözler önüne düşmemeli; onların anlamlı bir değişkende saklanması gerekir.

5. Hata Yönetimini Hafife Almayın

“Nasıl olsa çalışıyor” demek yerine, “hata verdiğinde ne olacak?” diye sorun. Sağlam hata kontrolü, temiz kodun önemli bir parçasıdır.

6. Kod Standartlarına Uyun (Lint, Formatter vb.)

Ekip çalışmasında en büyük sorunlardan biri stil farklılıklarıdır. Otomatik formatlayıcılar (Prettier, Black, ESLint vb.) sayesinde bu sorun tamamen ortadan kalkabilir.

7. Refactoring’i Ertelemeyin

“Sonra düzeltirim” çoğu zaman “asla düzeltilmeyecek” anlamına gelir. Yeni özellik eklerken eski kodları gözden geçirmek, geleceğe yatırım yapmaktır.

Sonuç

Temiz kod yazmak ekstra bir lüks değil; uzun vadede zaman kazandıran bir alışkanlıktır. Bugün 5 dakika fazla harcamak, yarın saatlerce debug yapmaktan iyidir.

← Ana Sayfaya Dön