Was bedeutet Clean Code im Projektalltag?

Warum Lesbarkeit Geld ist

Code wird einmal geschrieben und danach viele Male gelesen: bei jeder Änderung, bei jeder Fehlersuche, bei jedem Wechsel des Bearbeiters. Was beim Schreiben eine Viertelstunde spart, kann beim zehnten Lesen eine Stunde kosten.

Deshalb ist die Frage nicht „ist der Code schön", sondern: Wie lange braucht jemand, der ihn nicht geschrieben hat, um eine Änderung sicher vorzunehmen? Diese Zeit zahlen Sie bei jeder Erweiterung mit.

Fünf Eigenschaften, die man prüfen kann

• Namen sagen, was gemeint ist. `$liste` sagt nichts, `$offeneAuftraege` sagt alles — ohne Kommentar.
• Eine Funktion tut eine Sache. Wenn ihr Name ein „und" braucht, sind es zwei.
• Die Fachsprache des Betriebs steht im Code. Heißt der Vorgang bei Ihnen „Abruf", sollte er nicht „Order" heißen.
• Der Normalfall steht vorn, die Sonderfälle werden früh abgefangen. Verschachtelte Bedingungen über fünf Ebenen sind ein Warnzeichen.
• Es gibt Tests für die Fälle, die weh tun. Nicht für alles — für die, deren Fehlverhalten jemanden trifft.

// Schwer zu lesen: alles verschachtelt, nichts benannt
if ($a !== null) {
    if ($a->getStatus() === 2) {
        if (count($a->getItems()) > 0) {
            // ... die eigentliche Arbeit, vier Ebenen tief
        }
    }
}

// Lesbar: Sonderfaelle zuerst, Fachsprache im Namen
if ($auftrag === null) {
    return;
}
if (!$auftrag->istFreigegeben()) {
    return;
}
if ($auftrag->positionen() === []) {
    return;
}

// ... die eigentliche Arbeit, ohne Einrueckung

Wo der Begriff überreizt wird

„Das ist kein Clean Code" ist kein Argument, solange niemand sagt, welche konkrete Änderung dadurch teurer wird. Ein Umbau, der nur die Form ändert, hat einen Preis und keinen messbaren Nutzen — und er bringt das Risiko mit, funktionierendes Verhalten zu verändern.

Wir halten es deshalb so: Umgebaut wird, was gerade sowieso angefasst wird, und das in dem Umfang, den die anstehende Änderung braucht. Ein Umbau als eigenes Vorhaben braucht eine Begründung, die einen Namen hat — etwa eine Stelle, an der Fehler wiederholt entstanden sind.