Mit git bisect den verursachenden Commit finden

Ziel

Den Commit finden, der ein Verhalten von gut zu schlecht geändert hat, in logarithmischer Zeit, auch bei hunderten Commits.

Voraussetzungen

Eine reproduzierbare Prüfung mit dem Ergebnis «gut» oder «schlecht», ein bekannter guter und ein bekannter schlechter Commit, ein sauberer Arbeitsbaum.

Schritte

1. git bisect start, dann git bisect bad <schlecht> und git bisect good <gut>.
2. Bei manueller Prüfung: den ausgecheckten Commit prüfen und mit git bisect good oder git bisect bad antworten; Git wählt den nächsten Mittelpunkt.
3. Bei skriptbarer Prüfung: git bisect run <skript>; Exit-Code 0 bedeutet gut, 1–127 (ausser 125) schlecht, 125 überspringt einen nicht prüfbaren Commit.
4. Den gemeldeten ersten schlechten Commit lesen, dann git bisect reset.
5. Die Prüfung als dauerhaften Regressionstest übernehmen, bevor die Ursache behoben wird.

Erwartetes Ergebnis

Nach etwa log2(n) Prüfungen ist ein Commit benannt – der Ausgangspunkt für die Korrektur, nicht zwingend die Grundursache.

Grenzen und Prüfbasis

Bisect setzt einen einzigen Übergang voraus; flackernde Fehler oder mehrere Ursachen verwirren es. Nicht baubare Commits müssen übersprungen werden, was das Ergebnis zu einem Bereich verbreitern kann.