Git rebase#

Die Befehle git rebase und git merge ermöglichen das Zusammenführen von Git-Verzweigungen. Während git merge immer ein sich vorwärtsbewegender Änderungsansatz ist, verfügt git rebase über leistungsfähige Funktionen zum Umschreiben der Historie. Hier wollen wir die Konfiguration, Anwendungsfälle und Fallstricke genauer betrachten.

Dabei verschiebt git rebase eine Folge von Commits zu einem neuen Basis-Commit und kann so für Feature-Branches-Workflows nützlich sein. Intern erreicht Git dies, indem es neue Commits erstellt und diese auf die angegebene Basis anwendet; die gleichaussehenden Commits von Zweigen sind also völlig neue Commits.

Der Hauptgrund für git rebase ist, einen linearen Projektverlauf aufrechtzuerhalten. Wenn sich der Hauptzweig weiterentwickelt hat, seit ihr mit der Arbeit an einem Funktionszweig begonnen habt, wollt ihr vielleicht die letzten Aktualisierungen des Hauptzweigs in eurem Funktionszweig erhalten, aber die Historie eures Zweigs sauber halten. Dies hätte den Vorteil, dass ihr später ein sauberes git merge eures Funktionszweiges in den Hauptzweig durchführen könntet. Diese saubere Historie erleichtert euch auch, eine Regression mit Regressionen finden mit git bisect zu finden. Ein realistischeres Szenario wäre folgendes:

  1. Im Hauptzweig wird ein Fehler in einer Funktion festgestellt, die früher einmal fehlerfrei funktionierte.

  2. Durch die saubere Historie des Hauptzweigs sollte log und reflog schnell Rückschlüsse ermöglichen.

  3. Sollte log und reflog nicht zum gewünschten Ergebnis führen, hilft vermutlich git bisect weiter. Dabei hilft git bisect die saubere Git-Historie bei der Suche nach der Regression.

Warnung

Die veröffentlichte Historie sollte nur in sehr seltenen Ausnahmefällen geändert werden, da die alten Commits durch neue ersetzt und es so aussehen würde, als wäre dieser Teil der Projektgeschichte plötzlich verschwunden.

Bemerkung

git rebase wird auch kurz in Jupyter Notebooks unter Git und Feature-Branches behandelt

Rebase abhängiger Zweige mit –update-refs#

Wenn ihr an einem großen Feature arbeitet, ist es oft hilfreich, die Arbeit auf mehrere Zweige zu verteilen, die aufeinander aufbauen.

Diese Zweige können jedoch umständlich zu verwalten sein, wenn ihr den Verlauf in einem früheren Zweig überschreiben müsst. Da jeder Zweig von den vorherigen Zweigen abhängt, führt das Umschreiben von Commits in einem Zweig dazu, dass die nachfolgenden Zweige nicht mehr mit der Historie verbunden sind.

Git 2.38 wird mit einer neuen --update-refs-Option für git rebase ausgeliefert, die solche Aktualisierungen für euch durchführt , ohne dass ihr jeden einzelnen Zweig manuell aktualisieren müsst und ohne dass die nachfolgenden Zweige ihre Historie verlieren.

Wenn ihr diese Option bei jedem Rebase verwenden möchtet, könnt ihr git config --global rebase.updateRefs true ausführen, damit sich Git so verhält, als ob die Option --update-refs immer angegeben ist.

Commits mit git rebase löschen#

$ git rebase -i SHA origin/main

-i interaktiver Modus, in dem euer Standardeditor geöffnet wird und eine Liste aller Commits nach dem zu entfernenden Commit mit dem Hash-Wert SHA angezeigt wird, z.B.:

pick d82199e Update readme
pick 410266e Change import for the interface

Wenn ihr nun eine Zeile entfernt, so wird dieser Commit nach dem Speichern und Schließen des Editors gelöscht. Anschließend kann das entfernte Repository aktualisiert werden mit:

$ git push origin HEAD:main -f

Ändern einer Commit-Nachricht mit git rebase#

Dies lässt sich ebenfalls einfach mit git rebase realisieren wobei ihr in eurem Editor nicht die Zeile löschen sondern in der Zeile pick durch r (reword) ersetzen müsst.

rebase als Standard-git pull-Strategie#

Normalerweise holt und führt git pull neue Remote-Commits ohne Probleme zusammen. Meistens werden nur neue Commits aus dem entfernten Zweig hinzugefügt, ein sog. Fast-Forward-Merge. Wenn aber sowohl der lokale als auch der entfernte Zweig neue Commits haben, weichen die Zweige voneinander ab. Ihr müsst dann die verschiedenen Historien irgendwie in Einklang bringen. Standardmäßig führt ab Git 2.33.1 jede Abweichung dazu, dass git pull anhält und die folgende Meldung ausgibt:

$ git pull
Hinweis: Sie haben abweichende Branches und müssen angeben, wie mit diesen
Hinweis: umgegangen werden soll.
Hinweis: Sie können dies tun, indem Sie einen der folgenden Befehle vor dem
Hinweis: nächsten Pull ausführen:
Hinweis:
Hinweis:   git config pull.rebase false  # Merge
Hinweis:   git config pull.rebase true   # Rebase
Hinweis:   git config pull.ff only       # ausschließlich Vorspulen
Hinweis:
Hinweis: Sie können statt "git config" auch "git config --global" nutzen, um
Hinweis: einen Standard für alle Repositories festzulegen. Sie können auch die
Hinweis: Option --rebase, --no-rebase oder --ff-only auf der Kommandozeile nutzen,
Hinweis: um das konfigurierte Standardverhalten pro Aufruf zu überschreiben.
Schwerwiegend: Es muss angegeben werden, wie mit abweichenden Branches umgegangen werden sollen.

Die Hinweise erlauben drei Optionen:

git config pull.rebase false

führt die lokalen und entfernten Commits zusammen. Vor Git 2.33.1 verwendete Git immer diese Zusammenführung.

git config pull.rebase true

Die lokalen Commits werden auf die Remote-Commits übernommen.

git config pull.ff only

führt bei divergierenden Zweigen immer zu einen Fehler. Ihr könnt dann von Fall zu Fall mit --no-rebase (was merge bedeutet) oder --rebase entscheiden, ob ihr mergen oder rebasen wollt.

Tipp

Ich empfehle git config pull.rebase true, da Merging verwirrend sein kann. Das Rebasen der lokalen Commits auf die entfernten macht die Geschichte linear, was verständlicher ist.

Macht rebase zu eurer Standardstrategie mit:

$ git config --global pull.rebase interactive

Wenn git pull dann auf abweichende lokale und entfernte Zweige stößt, wird es ein rebase durchgeführt:

$ git pull
automatischer Merge von README.md
KONFLIKT (Inhalt): Merge-Konflikt in README.md
Fehler: Konnte e50dfe5... nicht anwenden
Hinweis: Resolve all conflicts manually, mark them as resolved with
Hinweis: "git add/rm <conflicted_files>", then run "git rebase --continue".
Hinweis: You can instead skip this commit: run "git rebase --skip".
Hinweis: To abort and get back to the state before "git rebase", run "git rebase --abort".
Konnte e50dfe5... nicht anwenden