Clean Code Prensipleri: Daha İyi Yazılım Yazmanın Anahtarları

Kod yazmak kolay, iyi kod yazmak ise sanattır. Robert C. Martin’in Clean Code kitabından ilham alan bu yazıda, günlük geliştirme akışına entegre edebileceğiniz somut prensipleri inceleyeceğiz.

1. Anlamlı İsimlendirme

Bir değişken veya fonksiyon ismi, ne yaptığını açıkça ifade etmelidir. Yorum yazmaya ihtiyaç duyuyorsanız, isim yetersiz demektir.

Kötü Örnek

// Kullanıcı yaşını gün cinsinden hesapla
function calc(d) {
    var t = new Date();
    return Math.floor((t - d) / 86400000);
}

İyi Örnek

const MILLISECONDS_PER_DAY = 86400000;

function calculateUserAgeInDays(birthDate) {
    const today = new Date();
    return Math.floor((today - birthDate) / MILLISECONDS_PER_DAY);
}

2. Küçük Fonksiyonlar

Bir fonksiyon tek bir iş yapmalı ve onu iyi yapmalı. İdeal uzunluk? Çoğu durumda 20 satırı geçmemeli.

The first rule of functions is that they should be small. The second rule is that they should be smaller than that.
— Robert C. Martin

3. DRY Prensibi (Don’t Repeat Yourself)

Aynı kod parçası 3 kere tekrar ediyorsa, bir yerde yanlış yapıyorsunuzdur. Tekrarı ortadan kaldırın:

// Önce
function validateEmail(email) {
    if (!email.includes("@")) return false;
    if (email.length < 5) return false;
    return true;
}

function validateUsername(username) {
    if (username.length < 5) return false;
    return true;
}

// Sonra
function hasMinLength(value, min = 5) {
    return value.length >= min;
}

function isValidEmail(email) {
    return email.includes("@") && hasMinLength(email);
}

function isValidUsername(username) {
    return hasMinLength(username);
}

4. Yorumlar Yerine Açıklayıcı Kod

Yorum, kötü kodun bahanesidir. Kodun kendisi kendini açıklamalıdır:

// Kötü
// 18 yaşından büyük mü kontrol et
if (user.age > 18) { ... }

// İyi
const MINIMUM_AGE = 18;
const isAdult = user.age >= MINIMUM_AGE;
if (isAdult) { ... }

5. Boy Scout Rule

Bir kod parçasını bulduğun durumdan daha temiz bırak. Her PR’da küçük iyileştirmeler yap. Zamanla codebase’in kalitesi katlanarak artar.

Sonuç

Clean code, sadece teknik bir disiplin değil, profesyonel bir tutumdur. Yazdığınız kod, gelecekteki sizin (veya başkasının) okuyacağı bir hikayedir. Onu okumaya değer kılın.

Önerilen Kaynaklar:

• Clean Code — Robert C. Martin
• The Pragmatic Programmer — Hunt & Thomas
• Refactoring — Martin Fowler