Yazılım

Temiz Kod Yazma Sanatı: İlkeler ve Pratikler

Okunabilir, sürdürülebilir ve test edilebilir kod yazmanın temel prensipleri. Basitlik karmaşıklığı yener.

8 Ocak 2024
6 dk okuma

Temiz Kod Yazma Sanatı: İlkeler ve Pratikler

Temiz kod yazmak, sadece çalışan kod yazmak değildir. Başkalarının (ve gelecekteki kendinizin) anlayabileceği, değiştirebileceği ve genişletebileceği kod yazmaktır.

Neden Temiz Kod?

Kod bir kez yazılır, onlarca kez okunur. Okuma/yazma oranı genellikle 10:1 veya daha yüksektir. Bu nedenle, yazma süresinden tasarruf etmek için okunabilirlikten ödün vermek uzun vadede maliyetlidir.

Temel İlkeler

1. İsimlendirme Önemlidir

İyi isimler kod yorumlarına olan ihtiyacı azaltır:

typescript
// Kötü
const d = new Date();
const x = users.filter(u => u.a);

// İyi
const currentDate = new Date();
const activeUsers = users.filter(user => user.isActive);

2. Fonksiyonlar Küçük Olmalı

Her fonksiyon tek bir şey yapmalı ve onu iyi yapmalı:

typescript
// Kötü: Birden fazla sorumluluğu var
function processUserData(user: User) {
  validateUser(user);
  saveToDatabase(user);
  sendWelcomeEmail(user);
  updateAnalytics(user);
}

// İyi: Her fonksiyon tek bir iş yapıyor
function onUserRegistration(user: User) {
  validateUser(user);
  persistUser(user);
  notifyUser(user);
  trackRegistration(user);
}

3. Soyutlama Seviyeleri

Bir fonksiyon içindeki tüm ifadeler aynı soyutlama seviyesinde olmalı.

Pratik Tavsiyeler

  1. Erken döndür: İç içe geçmiş if'ler yerine guard clause kullan
  2. Yorumlardan kaçın: Kod kendini açıklasın
  3. DRY ilkesi: Kendini tekrar etme, ama aşırıya kaçma
  4. Test et: Testler dokümantasyondur

Sonuç

Temiz kod yazmak bir alışkanlıktır. Her gün küçük iyileştirmeler yaparak bu alışkanlığı geliştirebilirsiniz.