Refactoring in kleinen, geprüften Schritten

Ziel

Bestehenden Code lesbarer und günstiger änderbar machen und dabei Schritt für Schritt nachweisen, dass sein beobachtbares Verhalten gleich bleibt.

Voraussetzungen

Fowlers Definition: Ein Refactoring ist eine Änderung der inneren Struktur von Software, die sie leichter verständlich und billiger änderbar macht, ohne ihr beobachtbares Verhalten zu ändern. Das setzt Tests voraus, die dieses Verhalten festhalten. Fehlen sie, zuerst Charakterisierungstests schreiben: den Code mit repräsentativen Eingaben aufrufen und die heutigen Ausgaben als Erwartung festschreiben, auch wenn sie seltsam wirken. Dazu der Katalog auf refactoring.com mit benannten Schritten wie Extract Function, Inline Function, Move Function, Rename Variable oder Introduce Parameter Object, und eine Testsuite, die in Sekunden läuft.

Schritte

1. Den Zielzustand und den Geruch benennen, der weg soll (lange Funktion, doppelter Code, Datenklumpen); den Satz als Entwurf der Commit-Nachricht notieren.
2. Ein einziges benanntes Refactoring anwenden, wo möglich mit der Automatik des Editors, die Umbenennen und Extrahieren über alle Aufrufstellen hinweg erledigt.
3. Tests laufen lassen. Rot heisst: Schritt rückgängig machen (Editor-Undo oder, wenn der letzte grüne Stand committet ist, git restore .), nicht vorwärts debuggen; der Schritt war zu gross oder das Verhalten ist doch nicht abgedeckt.
4. Nach jeder sinnvollen Gruppe grüner Schritte committen, mit einer Nachricht, die mit refactor: beginnt und keine Verhaltensänderung verspricht.
5. Verhaltensänderungen strikt in eigene Commits legen, davor oder danach. Reviewer müssen sich darauf verlassen können, dass ein Refactoring-Diff verhaltensneutral ist; dann lesen sie ihn nach Struktur statt Zeile für Zeile.
6. Aufhören, sobald der Geruch weg ist. Spekulative Verallgemeinerung («das brauchen wir sicher noch») ist ein neuer Geruch, kein Refactoring.

Erwartetes Ergebnis

Eine Folge kleiner Commits, jeder grün, jeder in Minuten prüfbar, die zusammen die beabsichtigte Struktur ergeben – und eine Testsuite, die unterwegs vollständiger geworden ist.

Grenzen und Prüfbasis

Tests schützen nur, was sie abdecken; Laufzeit, Speicherverbrauch und Nebenläufigkeit können sich unbemerkt ändern. Umbauten über Modulgrenzen hinweg brauchen dieselbe Disziplin plus einen Plan, etwa das Strangler-Fig-Muster. Definition und Katalog folgen den zitierten Seiten; die Schrittfolge ist ein Vorschlag ohne Messung.