Anwenden von Änderungen durch einen Rebase

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Git verwaltet automatisch einen Verlauf Ihrer Entwicklungen in einem Branch, indem jeder neue Commit mit seinem Vorgänger verknüpft wird. Wenn Sie einen Branch mit einem anderen mergen, kann der Verlauf unübersichtlicher werden. Beispiel: Ein No-Fast-Forward-Merge kombiniert divergente Entwicklungslinien, indem ein Mergecommit mit mehreren Vorgängern erstellt wird. Umgekehrt kombiniert ein Git Rebase-Befehl divergente Entwicklungslinien, ohne einen Mergecommit zu erstellen, was zu einem einfacheren Commitverlauf führt, im Endeffekt allerdings weniger Informationen zum Merge enthält. Welchen Mergetyp Sie auswählen, hängt wahrscheinlich davon ab, ob Sie eine Aufzeichnung des Mergevorgangs beibehalten oder den Commitverlauf vereinfachen möchten.

In diesem Artikel wird erläutert, wann anstelle eines No-Fast-Forward-Mergevorgangs ein Rebase verwendet werden sollte. Außerdem werden Verfahren für die folgenden Aufgaben beschrieben:

• Ausführen eines Rebasevorgangs für Ihren lokalen Branch
• Ausführen eines Force Push-Vorgangs für Ihren lokalen Branch nach einem Rebase
• Ausführen eines Interaktiven Rebasevorgangs zum Squashen lokaler Commits

Eine Übersicht über den Git-Workflow finden Sie im Azure Repos-Git-Tutorial.

Ausführen eines Rebasevorgangs für Ihren lokalen Branch

Git Rebase integriert Commits aus einem Quellbranch in Ihren aktuellen lokalen Branch (Zielbranch). Der Quellbranch bleibt unverändert. Zum Vergleich sind Git Rebase und weitere Mergetypen im folgenden Diagramm dargestellt.

Bei Git Rebase wird der Commitverlauf des Zielbranchs neu sequenziert, sodass er alle Commits im Quellbranch gefolgt von allen Commits im Zielbranch seit dem letzten gemeinsamen Commit enthält. Eine weitere Möglichkeit dafür besteht darin, dass ein Rebasevorgang die Änderungen in Ihrem Zielbranch über dem Quellbranchverlauf wiederholt. Insbesondere ändert Git Rebase die Reihenfolge der vorhandenen Commits im Zielbranch, was bei den anderen Mergestrategien nicht der Fall ist. Im obigen Diagramm enthält Commit K' die gleichen Änderungen wie K, verfügt aber über eine neue Commit-ID, da er mit dem Commit E anstelle von C verknüpft ist.

Wenn während eines Rebasevorgangs eine Quellbranchänderung einer Zielbranchänderung widerspricht, werden Sie von Git aufgefordert, den Mergekonflikt zu beheben. Sie können Mergekonflikte während eines Rebasevorgangs auf dieselbe Weise lösen wie Mergekonflikte während eines Mergevorgangs.

Rebase und No-Fast-Forward-Merge im Vergleich

Git Rebase führt zu einem einfacheren, aber weniger exakten Commitverlauf als ein No-Fast-Forward-Merge, der auch als Drei-Wege- oder True-Merge bezeichnet wird. Wenn Sie eine Aufzeichnung eines Mergevorgangs im Commitverlauf verwenden möchten, führen Sie einen No-Fast-Forward-Merge aus.

Wenn Sie die einzige Person sind, die an einem Feature- oder Bugfixbranch arbeitet, sollten Sie ein Rebase verwenden, um aktuelle Arbeit aus dem main-Branch regelmäßig darin zu integrieren. Mithilfe dieser Strategie können Sie sich über die aktuellen Arbeiten anderer informieren und eventuell auftretende Mergekonflikte direkt beheben. Durch die Ausführung eines Rebase implementieren Sie Ihr neues Feature oberhalb der letzten Arbeit im main-Branch, wodurch Sie einen linearen Commitverlauf erhalten.

Weitere Informationen zu Git Rebase und zu dessen Verwendung finden Sie unter Rebase und Merge im Vergleich.

Richtlinien zu Rebase und Force Push

Wenn Sie für einen lokalen Branch, den Sie zuvor gepusht haben, ein Rebase ausführen und dann den standardmäßigen Git Push-Befehl erneut ausführen, schlägt der Pushvorgang fehl. Durch den standardmäßigen Git Push-Befehl wird ein Fast-Forward-Merge angewendet, um Ihren lokalen Branch in den Remotebranch zu integrieren. Dieser Befehl schlägt nach einem Rebase fehl, da die Reihenfolge vorhandener Commits in Ihrem lokalen Zielbranch vom Rebasevorgang geändert wird, sodass er nicht mehr mit dem Verlauf des entsprechenden Remotebranchs übereinstimmt. In diesem Szenario ist Force Push erfolgreich, indem der Remotebranch überschrieben wird.

Git Rebase und Force Push sind leistungsstarke Tools, allerdings sollten Sie vor der Entscheidung, die Befehle zu verwenden, diese Richtlinien beachten:

• Führen Sie keinen Rebase für einen lokalen Branch aus, der gepusht und für andere freigegeben wurde, es sei denn, Sie sind sicher, dass der freigegebene Branch von niemandem verwendet wird. Nach einem Rebase stimmt Ihr lokaler Branch nicht mehr mit dem Verlauf seines entsprechenden Remotebranchs überein.
• Führen Sie keinen Force Push auf einen Remotebranch aus, der von anderen verwendet wird, da die lokale Version des Remotebranchs nicht mehr mit dem Verlauf des aktualisierten Remotebranchs übereinstimmt.
• Ihr Team sollte sich einigen, welche Verwendungsszenarien für Rebase und Force Push gelten.

Tipp

Verwenden Sie für einen gemeinsamen Überprüfungsprozess einen Pull Request, um neue Arbeit in den Standardbranch eines Remoterepositorys zu mergen.

So führen Sie einen Rebase aus

Visual Studio 2022

Visual Studio 2022 bietet Git-Versionskontrolle mithilfe des Git-Menüs, Git-Änderungen sowie über Kontextmenüs im Projektmappen-Explorer. Visual Studio 2019, Version 16.8, bietet auch die Team Explorer-Git-Benutzeroberfläche. Weitere Informationen finden Sie auf der Registerkarte Visual Studio 2019 – Team Explorer.

1. Wählen Sie Git > Branches verwalten aus, um das Fenster Git-Repository zu öffnen.

   

2. Klicken Sie im Fenster Git-Repository mit der rechten Maustaste auf den Zielbranch, und wählen Sie Check-Out aus.

   

3. Klicken Sie mit der rechten Maustaste auf den Quellbranch, und wählen Sie Rebase für <Zielbranch> ausführen auf <Quellbranch> aus.

   

4. Visual Studio zeigt nach einem erfolgreichen Rebasevorgang eine Bestätigungsmeldung an.

   

   Wenn der Rebasevorgang aufgrund von Mergekonflikten angehalten wird, werden Sie von Visual Studio benachrichtigt. Sie können entweder Konflikte lösen oder den Rebasevorgang abbrechen und zum Zustand vor dem Rebasevorgang zurückkehren.

   

Visual Studio 2019 – Git-Menü

Visual Studio 2019 bietet Git-Versionskontrolle über das Git-Menü, Git-Änderungen und über die Kontextmenüs im Projektmappen-Explorer.

1. Wählen Sie Git > Branches verwalten aus, um das Fenster Git-Repository zu öffnen.

   

2. Klicken Sie im Fenster Git-Repository mit der rechten Maustaste auf den Zielbranch, und wählen Sie Check-Out aus.

   

3. Klicken Sie mit der rechten Maustaste auf den Quellbranch, und wählen Sie Rebase für <Zielbranch> ausführen auf <Quellbranch> aus.

   

4. Visual Studio zeigt nach einem erfolgreichen Rebasevorgang eine Bestätigungsmeldung an.

   

   Wenn der Rebasevorgang aufgrund von Mergekonflikten angehalten wird, werden Sie von Visual Studio benachrichtigt. Sie können entweder Konflikte lösen oder den Rebasevorgang abbrechen und zum Zustand vor dem Rebasevorgang zurückkehren.

   

Visual Studio 2019 – Team Explorer

Visual Studio 2019, Version 16.8 und höher, bietet eine Benutzeroberfläche für Git-Versionskontrolle, während die Team Explorer-Git-Benutzeroberfläche beibehalten wird. Um Team Explorer zu verwenden, deaktivieren Sie in der Menüleiste Extras>Optionen>Vorschaufeatures>Neue Git-Benutzeroberfläche. Sie können Git-Features über beide Oberflächen nutzen.

1. Wählen Sie in Team Explorer die Option Start und dann Branches aus.

   

2. Klicken Sie in der Ansicht Branches mit der rechten Maustaste auf den Zielbranch, und wählen Sie Check-Out aus.

   

3. Klicken Sie mit der rechten Maustaste auf den Quellbranch, und wählen Sie Rebase ausführen auf aus.

   

4. Überprüfen Sie die Rebaseoptionen, und klicken Sie dann auf Rebase ausführen.

   

5. Visual Studio zeigt nach einem erfolgreichen Rebasevorgang eine Bestätigungsmeldung an.

   

   Wenn während des Rebasevorgangs Konflikte auftreten, werden Sie von Visual Studio benachrichtigt. Sie können entweder Konflikte lösen oder den Rebasevorgang abbrechen und zum Zustand vor dem Rebasevorgang zurückkehren.

   

Git-Befehlszeile

Führen Sie den git rebase-Befehl aus, um Quellbranchcommits in einen Zielbranch zu integrieren:

git rebase <source branch name> <target branch name>

Wenn Ihr aktueller lokaler Branch der Zielbranch ist, können Sie den Rebase-Befehl wie folgt vereinfachen:

git rebase <source branch name>

Sie werden von Git benachrichtigt, wenn beim Rebasevorgang Konflikte auftreten. Sie können entweder die Konflikte lösen und dann git rebase --continue ausführen, oder Sie können git rebase --abort ausführen, um den Rebasevorgang rückgängig zu machen und zum Zustand vor dem Rebase zurückzukehren.

Ausführen eines Force Push-Vorgangs für Ihren lokalen Branch nach einem Rebase

Wenn Sie ein Rebase für einen lokalen Branch ausführen, den Sie zuvor gepusht haben, verursacht ein nachfolgender standardmäßiger Git Push einen Fehler. Stattdessen können Sie für Ihren lokalen Branch einen Force Push ausführen, um seinen entsprechenden Remotebranch zu überschreiben, damit ihre Commitverläufe übereinstimmen.

Warnung

Ein Force Push darf niemals für einen Branch ausgeführt werden, an dem andere arbeiten. Weitere Informationen finden Sie unter Richtlinien zu Rebase und Force Push.

Um in Visual Studio einen Force Push auszuführen, müssen Sie zuerst die Force Push-Option aktivieren:

1. Navigieren Sie zu Extras>Optionen>Quellcodeverwaltung>Globale Git-Einstellungen.

2. Wählen Sie die Option „push --force-with-lease“ aktivieren aus.

Das --force-with-lease-Flag von Git Push ist sicherer als das --force-Flag, da es keinen Remotebranch überschreibt, der Commits enthält, die nicht in den lokalen Branch integriert sind, für den Sie einen Force Push ausführen.

Visual Studio 2022

1. Wählen Sie im Fenster Git-Änderungen die Schaltfläche „Pushen“ aus, um den Commit zu pushen.

   

   Alternativ können Sie im Git-Menü Pushen auswählen.

   

2. Wenn der Standardmäßige Git Push-Vorgang fehlschlägt, öffnet Visual Studio das Dialogfeld Git Push-Fehler. Wählen Sie Push erzwingen aus.

   

3. Visual Studio zeigt nach einem erfolgreichen Pushvorgang eine Bestätigungsmeldung an.

   

Visual Studio 2019 – Git-Menü

1. Wählen Sie im Fenster Git-Änderungen die Schaltfläche „Pushen“ aus, um den Commit zu pushen.

   

   Alternativ können Sie im Git-Menü Pushen auswählen.

   

2. Wenn der Standardmäßige Git Push-Vorgang fehlschlägt, öffnet Visual Studio das Dialogfeld Git Push-Fehler. Wählen Sie Push erzwingen aus.

   

3. Visual Studio zeigt nach einem erfolgreichen Pushvorgang eine Bestätigungsmeldung an.

   

Visual Studio 2019 – Team Explorer

Visual Studio 2019, Version 16.8 und höher, bietet eine Benutzeroberfläche für Git-Versionskontrolle, während die Team Explorer-Git-Benutzeroberfläche beibehalten wird. Um Team Explorer zu verwenden, deaktivieren Sie in der Menüleiste Extras>Optionen>Vorschaufeatures>Neue Git-Benutzeroberfläche. Sie können Git-Features über beide Oberflächen nutzen.

1. Wählen Sie in Team Explorer die Option Start und dann Synchronisieren aus, um die Ansicht Synchronisierung zu öffnen.

   

2. Wählen Sie in der Ansicht Synchronisierung die Option Pushen aus, um Ihre Änderungen in das Remoterepository hochzuladen.

   

3. Wenn der Standardmäßige Git Push-Vorgang fehlschlägt, öffnet Visual Studio das Dialogfeld Git Push-Fehler. Wählen Sie Push erzwingen aus.

   

4. Visual Studio zeigt nach einem erfolgreichen Pushvorgang eine Bestätigungsmeldung an.

   

Git-Befehlszeile

Tipp

Das --force-with-lease-Flag von Git Push ist sicherer als das --force-Flag, da es keinen Remotebranch überschreibt, der Commits enthält, die nicht in den lokalen Branch integriert sind, für den Sie einen Force Push ausführen.

So führen Sie einen Force Push für neue Commits von Ihrem lokalen Branch in einen gleichnamigen Remotebranch aus:

git push --force-with-lease <remote> <local branch name>

Wenn der Branch, den Sie pushen möchten, Ihr ausgecheckter Branch ist, können Sie den Force Push-Befehl wie folgt vereinfachen:

git push --force-with-lease <remote>

Wenn Sie ein Remoterepository klonen, weist Git den Alias origin als Kürzel für die URL des geklonten Remoterepositorys zu. Führen Sie git remote -v aus, um den Wert von Alias origin zu überprüfen. Um den Alias origin manuell hinzuzufügen, führen Sie git remote add origin <remote repo url> aus. Mit dem Alias origin können Sie den Force Push-Befehl weiter vereinfachen:

git push --force-with-lease origin

Wenn Ihr aktueller lokaler Branch einen Remotebranch auf origin nachverfolgt, können Sie den Force Push-Befehl vollständig abkürzen:

git push --force-with-lease

Der vollständig abgekürzte Pushbefehl schlägt jedoch fehl, wenn von Ihrem lokalen Branch kein Remotebranch nachverfolgt wird. Führen Sie git remote show origin aus, um den Nachverfolgungsstatus Ihrer Branches zu überprüfen.

Ausführen eines Interaktiven Rebasevorgangs zum Squashen lokaler Commits

Wenn Sie an einem neuen Feature in Ihrem lokalen Featurebranch arbeiten, generieren Sie in der Regel mehrere Commits. Wenn Sie bereit sind, das neue Feature zu veröffentlichen, können Sie diese Commits in einem einzelnen Commit konsolidieren, um den Commitverlauf zu vereinfachen. Sie können einen interaktiven Rebase-Befehl verwenden, um mehrere Commits in einem einzelnen Commit zu squashen.

Visual Studio 2022

Visual Studio 2022 unterstützt keine interaktiven Rebasevorgänge. Verwenden Sie stattdessen die Git-Befehlszeile.

Visual Studio 2019 – Git-Menü

Visual Studio 2019 unterstützt keine interaktiven Rebasevorgänge. Verwenden Sie stattdessen die Git-Befehlszeile.

Visual Studio 2019 – Team Explorer

Visual Studio 2019 unterstützt keine interaktiven Rebasevorgänge. Verwenden Sie stattdessen die Git-Befehlszeile.

Git-Befehlszeile

1. Checken Sie den lokalen Branch aus, für den Sie einen interaktiven Rebasevorgang ausführen möchten.

2. Committen, stashen oder verwerfen Sie alle ausgecheckten Änderungen.

3. Schätzen Sie, wie weit sie im Commitverlauf zurückgehen möchten. Sie müssen nicht genau sein, da Sie beim Ausführen des interaktiven Rebase-Befehls die Commits auswählen können, die Sie squashen möchten. Wenn Sie beispielsweise Commits innerhalb der letzten fünf Commits squashen möchten, führen Sie folgenden Befehl aus:

   git rebase -i HEAD~5
   

   Git öffnet einen Editor, in dem die letzten fünf Commits beginnend mit dem neuesten Commit aufgelistet werden. Beispiel:

   pick 7068b09 Update README network switch section
   pick 9d247f7 Update README network controller section
   pick 5d7ab9f Fix fiber optic transmitter test
   pick 7b43f3f Add network switch test
   pick 00859d9 Add network controller test
   

4. Lassen Sie die erste Zeile unverändert. Ändern Sie pick in den nachfolgenden Zeilen in squash, um einen Commit mit dem darüber zu mergen. Wenn Sie beispielsweise die beiden obersten Commits sowie die beiden untersten Commits kombinieren möchten, ändern Sie die Commitliste wie folgt:

   pick 7068b09 Update README network switch section
   squash 9d247f7 Update README network controller section
   pick 5d7ab9f Fix fiber optic transmitter test
   pick 7b43f3f Add network switch test
   squash 00859d9 Add network controller test
   

5. Speichern Sie, und schließen Sie den Editor. Anschließend öffnet Git für jeden Satz gemergter Commits einen neuen Editor, und Sie werden aufgefordert, eine Commitnachricht einzugeben. Fassen Sie die Commitnachrichten für jeden Commitsatz in einer Nachricht zusammen, und speichern und schließen Sie den Editor. Im vorherigen Beispiel werden die gesquashten Commits mit neuen Commitnachrichten zusammengefasst:

   8fcb88f Update README network sections
   ac6d3c0 Fix fiber optic transmitter test
   f0aadc3 Add two network tests
   

   Obwohl der Fix fiber optic transmitter test-Commit nicht gesquasht wurde, verfügt er über eine neue Commit-ID, da er jetzt mit einem anderen Vorgängercommit verknüpft ist.

Weitere Informationen zu interaktiven Rebasevorgängen finden Sie unter Git Rebase im interaktiven Modus ausführen.

Hinweis

Azure DevOps-Benutzer können einen Squashmerge ausführen, um den Commitverlauf eines Topic-Branchs während eines Pull Requests zusammenzufassen.

Nächste Schritte

Kopieren von Änderungen durch einen Cherry-Pick

Verwandte Artikel

• Neu bei Git-Repositorys? Weitere Informationen
• Freigeben eines Codes mithilfe von Push
• Aktualisieren von Code mit Fetch, Merge und Pull