ANKA MÜHENDİSLİKSincan / Ankara
Yazılım Temelleri • Orta

Clean Code (Temiz Kod) nedir?

Clean Code

Okunması, anlaşılması ve değiştirilmesi kolay; amacını açıkça ifade eden kod yazma anlayışı.

Temiz kod, yalnızca çalışan değil, başka bir geliştiricinin (ya da altı ay sonraki sizin) kolayca okuyup anlayabileceği ve güvenle değiştirebileceği koddur. Kod, yazıldığından çok daha fazla okunur; bu nedenle okunabilirlik uzun vadede en değerli özelliklerden biridir. Kavram, Robert C. Martin'in 'Clean Code' kitabıyla popülerleşmiştir.

Temel ilkeler şunlardır: değişken ve fonksiyonlara amacını anlatan isimler vermek; fonksiyonları kısa tutmak ve her birinin tek bir iş yapmasını sağlamak; tekrardan kaçınmak (DRY: Don't Repeat Yourself); gereksiz karmaşıklıktan kaçınmak (KISS: Keep It Simple); kodun ne yaptığını değil neden yaptığını açıklayan yorumlar yazmak ve tutarlı bir biçimlendirme kullanmak.

Temiz kod bir kural listesi değil, bir alışkanlıktır. Ekip içinde ortak bir kod stili belirlemek ve bunu Prettier, Black veya ESLint gibi araçlarla otomatikleştirmek tartışmaları azaltır. Kod incelemeleri (code review) ve düzenli refactoring, kod tabanının zamanla bozulmasını engeller.

Örnek: Aynı kodun okunaksız ve temiz hali

// Okunaksız
function f(a) { return a.filter(x => x.s === 1 && x.d > 18).map(x => x.n); }

// Temiz
const AKTIF = 1;
const RESIT_YAS = 18;

function aktifYetiskinAdlari(kullanicilar) {
  return kullanicilar
    .filter(k => k.durum === AKTIF && k.yas > RESIT_YAS)
    .map(k => k.ad);
}

İpuçları

  • Bir fonksiyonu açıklamak için uzun bir yorum yazmanız gerekiyorsa, önce daha iyi isimlerle ve bölerek sadeleştirmeyi deneyin.
  • Biçimlendirmeyi elle değil, otomatik bir formatter ile yapın.