Clean Code Nedir?

Kod bir kez yazılır, yüzlerce kez okunur. Clean code, kodun bakım maliyetini düşürür. Karmaşık mimariler yerine doğrudan, anlaşılır çözümler sunar. Modern web standartlarında ve hızlı teslimat gerektiren dijital ajans projelerinde teknik borcu engeller.

Adım 1: Anlamlı İsimlendirme

Değişken ve fonksiyon isimleri amacı açıkça belirtmelidir. Kısaltmalar ve anlamsız tek harfli değişkenler okunurluğu yok eder.

Kötü: let d; // geçen gün sayısı
İyi: const daysSinceLastLogin;
Kötü: function getUsr(id) {}
İyi: function getUserById(userId) {}

Adım 2: Küçük ve Tek Sorumluluk Sahibi Fonksiyonlar

Fonksiyon tek bir iş yapmalıdır (Single Responsibility). 20 satırdan uzun fonksiyonları bölün. Parametre sayısını en fazla 2-3 seviyesinde tutun.

Kural: Fonksiyon adı 'and' veya 've' içeriyorsa iki farklı iş yapıyordur. Bölün.

Adım 3: Erken Dönüş (Early Return) ile İç İçe Koşulları Yok Edin

Derin if-else blokları bilişsel yükü artırır. Hata durumlarını başta kontrol edip fonksiyondan çıkın.

// Kötü
function processPayment(user) {
  if (user) {
    if (user.hasCard) {
      // işlem
    }
  }
}

// İyi
function processPayment(user) {
  if (!user || !user.hasCard) return;
  // işlem
}

Adım 4: Yorum Satırı Yerine Açıklayıcı Kod

Kod kendini açıklamalıdır. 'Nasıl' çalıştığını anlatan yorumlar eski kodun ve kötü tasarımın işaretidir. Yalnızca 'Neden' yapıldığını belirten iş kurallarında yorum kullanın.

Modern Web Trendlerinde Clean Code

Yeni trendler gereksiz bağımlılıklardan (over-engineering) kaçınmayı zorunlu kılıyor. Dilin yerleşik (stdlib) özelliklerini kullanın. 3 satır kod için kütüphane eklemeyin. Proje boyutunu küçük, bağımlılıkları minimumda tutun.