Clean Code: Prinzipien für besseren, wartbaren Code

Code wird öfter gelesen als geschrieben. Clean Code ist Code, der leicht zu verstehen, zu ändern und zu erweitern ist. In diesem Artikel zeige ich Ihnen die wichtigsten Prinzipien, die Ihren Code von „funktioniert“ zu „professionell“ heben.

Was ist Clean Code?

Der Begriff wurde durch Robert C. Martin („Uncle Bob“) geprägt. Clean Code ist nicht nur Code, der funktioniert. Er ist Code, den andere Entwickler verstehen und weiterentwickeln können, ohne jede Zeile mühsam analysieren zu müssen.

Das Ziel: Code sollte sich lesen wie gut geschriebene Prosa. Die Absicht sollte sofort klar sein, ohne Kommentare als Krücke zu benötigen.

Aussagekräftige Namen

Namen sind überall: Variablen, Funktionen, Klassen, Dateien. Gute Namen eliminieren die Notwendigkeit für Kommentare.

let d; // verstrichene Tage
let list1;
function calc(a, b) { }
const data = fetchData();

let daysSinceCreation;
let activeUsers;
function calculateTax(price, rate) { }
const userProfile = fetchUserProfile();

Kleine Funktionen

Funktionen sollten eine Sache tun, und diese gut. Eine Funktion mit 200 Zeilen macht fast immer mehrere Dinge. Teilen Sie sie auf.

Die Parameter einer Funktion sollten minimal sein. Null bis zwei Parameter sind ideal. Bei mehr als drei sollten Sie überlegen, ob ein Objekt besser wäre:

// Schwer zu lesen und fehleranfällig
createUser("Max", "Mustermann", "max@email.de", true, "admin", 1);

// Besser: Ein Options-Objekt
createUser({
  firstName: "Max",
  lastName: "Mustermann",
  email: "max@email.de",
  isActive: true,
  role: "admin",
  departmentId: 1
});

DRY: Don’t Repeat Yourself

Duplizierter Code ist einer der größten Code Smells. Wenn Sie die gleiche Logik an mehreren Stellen haben, müssen Sie bei Änderungen jede Stelle finden und anpassen. Das führt unweigerlich zu Fehlern.

Extrahieren Sie duplizierten Code in wiederverwendbare Funktionen, Methoden oder Module. Aber Vorsicht: Nicht jede Ähnlichkeit ist Duplikation. Manchmal sieht Code ähnlich aus, hat aber unterschiedliche Gründe sich zu ändern.

SOLID-Prinzipien im Überblick

SOLID ist ein Akronym für fünf Prinzipien objektorientierten Designs:

Kommentare richtig einsetzen

Guter Code erklärt sich selbst. Kommentare sind oft ein Zeichen dafür, dass der Code nicht klar genug ist. Statt einen schlechten Namen zu kommentieren, wählen Sie einen besseren Namen.

Wann Kommentare sinnvoll sind:

Code Smells erkennen

Code Smells sind Hinweise auf tieferliegende Probleme:

Lange Methoden: Mehr als 20 Zeilen sind ein Warnsignal. Große Klassen: Wenn eine Klasse zu viele Verantwortlichkeiten hat. Lange Parameterlisten: Mehr als drei Parameter erschweren das Verständnis. Duplizierter Code: Die gleiche Logik an mehreren Stellen. Toter Code: Auskommentierter oder nie erreichter Code. Magic Numbers: Zahlen ohne erkennbare Bedeutung im Code.