Mi az a Clean Code?

Mi az a Clean Code?

A „clean code" – magyarul tiszta kód – olyan kódot jelent, amelyet könnyű olvasni, megérteni és módosítani. Nem csupán a szintaktikai helyességről van szó, hanem arról, hogy a kód kommunikál: elmondja, mit csinál és miért.

Bjarne Stroustrup, a C++ megalkotója szerint a tiszta kód olyan, „mint egy jól megírt próza: elegáns, hatékony és egyértelmű szándékú". Ward Cunningham megfogalmazásában: ha olvasod egy rutinját, és nem lepsz meg semmin – az tiszta kód.

Mit jelent a „rossz" kód?

A rossz kód – angolul dirty code vagy spaghetti code – a következő jellemzőket mutatja:

• Nehezen olvasható: változónevei rövidítések, a logika összetekeredett
• Nehezen módosítható: egy apró változtatás lavinát indít el más helyeken
• Nincs dokumentálva szándék szerint: nem derül ki, miért így működik
• Duplikált logika: ugyanaz a kódrészlet több helyen is szerepel
• Egyetlen nagy függvény: amely egyszerre csinál mindent

// ❌ Rossz példa – mi ez egyáltalán?
function proc(d, t, x) {
  let r = 0;
  for (let i = 0; i < d.length; i++) {
    if (d[i].type === t && d[i].val > x) {
      r += d[i].val;
    }
  }
  return r;
}

// ✅ Javított verzió – azonnal érthető
function sumItemsAboveThreshold(items, type, threshold) {
  return items
    .filter(item => item.type === type && item.value > threshold)
    .reduce((sum, item) => sum + item.value, 0);
}

Rövid összefoglaló

• A tiszta kód elsősorban az emberi olvashatóságra optimalizált, nem csupán a gépi futásra.
• A rossz kód jelei: érthetetlen nevek, összegubancolódott logika, duplikáció.
• A tiszta kód célja: kommunikáljon a szándékodról a jövőbeli olvasóval.