Ugrás a tartalomhoz

Clean Code

A Wikiszótárból, a nyitott szótárból

Angol


Főnév

Clean Code (tsz. Clean Codes)

  1. (informatika)

📘 Clean Code: A Handbook of Agile Software Craftsmanship

Szerző: Robert C. Martin (“Uncle Bob”) Megjelenés: 2008 Téma: Kódminőség, olvashatóság, szoftvermérnöki szemlélet


🧠 Miről szól a Clean Code?

A Clean Code egy modern, gyakorlatorientált kézikönyv, amely megtanít „szép”, tiszta, olvasható, karbantartható kódot írni. Nem egy konkrét nyelvet tanít (bár a példák főként Java-ban íródtak), hanem programozási szemléletet, amely minden nyelvre alkalmazható.


🎯 Alapvető üzenetei

✨ “A jó kódot nem a gépek, hanem az emberek számára írjuk.” ✨ “A tiszta kód olvasható, egyszerű, és nem meglepő.” ✨ “A kód nem működik jól addig, amíg nem olvasható jól.”

🧩 Fő témák (fejezetenként)

1. Tiszta kód ismérvei

  • Jó kód: könnyen olvasható, letisztult, tesztelhető.
  • Példák híres programozóktól: Ward Cunningham, Grady Booch.


2. Jó nevek

  • Beszédes, önmagukért beszélő változók, függvények, osztálynevek.
  • Kerüld: temp, data, a1, foo
  • Használj: calculateInvoiceTotal(), firstName, userRepository


3. Függvények

  • Rövid, egy dolgot csináljanak
  • Ne legyenek mellékhatások
  • Név + paraméter elegendő legyen a megértéshez


4. Megjegyzések (kommentek)

  • Használd ritkán – a kód magyarázza saját magát
  • Jó komment: miért, nem mit
  • Rossz komment: elavult, félrevezető, redundáns


5. Formázás

  • Fehér helyek, egységes behúzás
  • Függvények között megfelelő tér
  • Blokkstruktúra: strukturált vizuális navigáció


6. Objektum és adatstruktúrák

  • Ne tárd fel a belső adatokat közvetlenül
  • OOP: viselkedést kapsz adattal együtt
  • ADT (abstract data type) → adat + metódusok = kapszula


7. Hibakezelés

  • Ne használj try-catch-et normál vezérlésre
  • Kivételeket használj, ne hibakódokat
  • Clean Error Handling → olvasható, konzisztens, minimalizált hatás


8. Határok (Boundary)

  • Külső API-k, könyvtárak elkerítése saját adapter osztályba
  • Könnyebben tesztelhető, ha a külső komponens elkülönül


9. Tesztelhető kód

  • Egységtesztek = Clean Code társai
  • Nehezen tesztelhető kód → valószínűleg rosszul van szervezve
  • Tiszta kód = jól modularizált → jól tesztelhető


🔥 Kiemelkedő elvek és szabályok

Szabály Jelentés
SRP – Single Responsibility Principle Egy osztály csak egy dolgot csináljon
DRY – Don’t Repeat Yourself Ne ismételj kódot, vond össze
YAGNI – You Ain’t Gonna Need It Ne írj felesleges dolgokat előre
Boy Scout Rule „Hagyd a kódot jobb állapotban, mint ahogy találtad”


🧠 Hatása

  • Munkakörnyezetekben a kódreview-k szabályrendszerének alapja
  • Támogatta a “craftsmanship” mozgalmat: a programozás nem csak munka, hanem mesterség
  • Befolyásolta a későbbi könyveket: Clean Architecture, Clean Agile, Clean Coder


✅ TL;DR – Miért olvasd el?

Miért? Mire jó?
Jobb kódot akarsz írni Olvashatóbb, tesztelhetőbb
Tisztább osztály- és függvényszerkezet SRP, elnevezési konvenciók
Fejlesztői tudatosság növelése Refaktorálás, karbantartás
Jó alap kezdőknek és haladóknak is Modern szemlélet, gyakorlati példák


További információk

A lap eredeti címe: „https://hu.wiktionary.org/w/index.php?title=Clean_Code&oldid=3504575”