Lösen von Mergekonflikten

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

Visual Studio 2019 | Visual Studio 2022

Bei Ausführung eines Merge- oder Rebasevorgangs wird Git aufgefordert, Änderungen, die in einem Branch vorgenommen wurden, mit Änderungen an einem anderen Branch zu kombinieren. Häufig führt Git einen Merge- oder Rebasevorgang automatisch ohne Ihre Unterstützung durch. Wenn Git jedoch feststellt, dass eine Änderung, die in einem Branch vorgenommen wurde, einer Änderung in einem anderen Branch widerspricht, werden Sie aufgefordert, den Konflikt zu lösen. Ein Mergekonflikt kann auftreten, wenn eine Dateizeile in den zusammengeführten Branches unterschiedlich bearbeitet wurde oder wenn ein Branch eine Datei ändert und ein anderer Branch sie löscht. Die Vorgehensweise zum Auflösen von Mergekonflikten gilt sowohl für Git Merge als auch für Git Rebase.

Sie können Mergekonflikte in Visual Studio oder über Befehlszeile mit einem beliebigen Text-Editor lösen.

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

Dieser Artikel enthält Erläuterungen zu Verfahren für die folgenden Aufgaben:

• Grundlegendes zu Mergekonflikten
• Lösen von Mergekonflikten

Grundlegendes zu Mergekonflikten

Git Merge oder Git Rebase integriert Commits aus einem Quellbranch in Ihren aktuellen lokalen Branch (Zielbranch). Git Merge führt entweder einen Fast-Forward- oder No-Fast-Forward-Mergevorgang aus. Der No-Fast-Forward-Mergevorgang wird auch als Drei-Weg-Merge oder echter Mergevorgang bezeichnet. Git Rebase ist ein andere Art von Merge. Diese Mergetypen sind im folgenden Diagramm dargestellt.

Wenn für Git Merge die Spitze des Zielbranchs im Quellbranchs vorhanden ist, wird standardmäßig ein Fast-Forward Mergevorgang ausgeführt. Andernfalls wird standardmäßig ein No-Fast-Forward-Mergevorgang ausgeführt.

Bei einem Fast-Forward-Merge kann es nie zu einem Mergekonflikt kommen, da Git keinen Fast-Forward-Mergevorgang anwendet, wenn die Spitze des Zielbranchs vom Quellbranch abweicht. Standardmäßig verwendet Git nach Möglichkeit ein Fast-Forward-Merge. Git wendet z. B. ein Fast-Forward-Merge auf einen lokalen Branch an, den Sie lediglich durch Pullen aus dem entsprechenden Remotebranch aktualisieren.

Bei einem No-Fast-Forward-Merge wird ein neuer „Mergecommit“ des Zielbranchs generiert, der Änderungen im Quellbranch in Änderungen des Zielbranchs integriert. Die anwendbaren Änderungen sind die Änderungen, die nach dem letzten, für beide Branches gemeinsamen Commit vorgenommen wurden. Im obigen Diagramm ist Commit C das letzte gemeinsame Commit in beiden Branches. Wenn eine Quellbranchänderung einer Zielbranchänderung widerspricht, fordert Git Sie auf, den Mergekonflikt zu beheben. Der Mergecommit (L) enthält die integrierten Quellbranch- und Zielbranchänderungen. Die Quell- und Zielbranchspitzen (K und E) sind die übergeordneten Elemente des Mergecommits. Im Commitverlauf Ihres Branchs ist ein Mergecommit ein nützlicher Marker für einen Mergevorgang, der deutlich zeigt, welche Branches zusammengeführt wurden.

Bei einem 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. Im obigen Diagramm ist Commit C das letzte gemeinsame Commit in beiden Branches. Eine weitere Möglichkeit dafür besteht darin, dass ein Rebasevorgang die Änderungen in Ihrem Zielbranch über dem Quellbranchverlauf wiederholt. Wenn eine Quellbranchänderung einer Zielbranchänderung widerspricht, fordert Git Sie auf, den Mergekonflikt zu beheben. Wie beim Fast-Forward-Merge wird beim Rebase kein Mergecommit erstellt. Insbesondere ändert eine Rebasevorgang 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.

Bei Git Merge und Git Rebase wird nur der Zielbranch geändert. Der Quellbranch bleibt unverändert. Wenn dabei ein Mergekonflikt auftritt, müssen Sie diesen auflösen, um den Merge- oder Rebasevorgang durchzuführen. Alternativ können Sie den Merge-/Rebasevorgang abbrechen und den Zielbranch in den vorherigen Zustand zurücksetzen.

Weitere Informationen zu Mergeoptionen und -strategien finden Sie im Git-Referenzhandbuch und in der Dokumentation zu Git-Mergestrategien.

Gründe für das Lösen von Mergekonflikten

Git Merge und Git Rebase werden im Git-Workflow ausgiebig verwendet. Bei der Arbeit an einem lokalen Featurebranch oder Bugfixbranch haben sich folgende Verfahren bewährt:

1. Halten Sie Ihren lokalen main-Branch mit dem seinem entsprechenden Remoterepository auf dem aktuellen Stand, indem Sie regelmäßig pullen, um Remotecommits abzurufen und zusammenzuführen.
2. Integrieren Sie lokale main-Branchaktualisierungen mit einem Rebase oder Merge in Ihren lokalen Featurebranch.
3. Sichern Sie Ihre Arbeit im lokalen Featurebranch, indem Sie sie an den entsprechenden Remotebranch pushen.
4. Erstellen Sie nach Fertigstellung des Features einen Pull Request, um den Remotefeaturebranch mit dem main-Remotebranch zusammenzuführen.

Durch die häufige Integration von Remoteänderungen in Ihr lokales Repository sind Sie stets über die letzten Arbeiten anderer Personen informiert, sodass Sie auftretende Mergekonflikte umgehend lösen können.

Lösen von Mergekonflikten

Die Vorgehensweise zum Auflösen von Mergekonflikten gilt sowohl für Git Merge als auch für Git Rebase. Obwohl in den folgenden Schritten beschrieben wird, wie Mergekonflikte bei einem Mergevorgang gelöst werden, können Sie Mergekonflikte bei einem Rebasevorgang auf ähnliche Weise lösen.

Tipp

Wenn es sich bei dem Quellbranch um einen Remotenachverfolgungsbranch handelt, muss sichergestellt sein, dass der Branch auf dem neuesten Stand ist, indem Sie vor einem Merge ein Git Fetch ausführen. Sie können auch den Git Pull-Befehl ausführen, der ein Git Fetch mit einem Git Merge kombiniert.

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. Checken Sie den Zielbranch im Bereich Branches im Fenster Git-Repository aus. Klicken Sie dann mit der rechten Maustaste auf den Quellbranch, und wählen Sie Mergen von <Quellbranch> in <Zielbranch> aus.

   

2. Visual Studio benachrichtigt Sie, wenn Git den Mergevorgang aufgrund von Konflikten angehalten hat. In diesem Fall können Sie entweder die Konflikte lösen oder den Mergevorgang abbrechen und zum Zustand vor dem Mergevorgang zurückkehren. Im Abschnitt Nicht gemergte Änderungen im Fenster Git-Änderungen wird die Liste der Dateien mit Mergekonflikten angezeigt. Doppelklicken Sie bei einer Datei mit Mergekonflikten in ihrem Inhalt auf die Datei, um sie im Merge-Editor zu öffnen.

   

3. Im Merge-Editor werden im Bereich Eingehend die Version der Quellbranchdatei, im Bereich Aktuell die Version der Zielbranchdatei und im Bereich Ergebnis die resultierende Mergedatei angezeigt. Um bestimmte Quell- oder Zielbranchänderungen anzuwenden, aktivieren Sie das Kontrollkästchen neben den in Konflikt stehenden Zeilen, die Sie beibehalten möchten. Sie können die Mergedatei auch direkt im Bereich Ergebnis bearbeiten. Wählen Sie Merge akzeptieren aus, nachdem Sie alle Mergekonflikte in der aktuellen Datei behoben haben. Wiederholen Sie diesen Schritt für jede Datei mit Inhaltskonflikten.

   

4. Klicken Sie für eine Datei, die in einem Branch bearbeitet und im anderen gelöscht wurde, mit der rechten Maustaste auf die Datei, und wählen Sie die gewünschte Branchaktion aus.

   

5. Geben Sie im Fenster „Git-Änderungen“ eine Commitnachricht ein, und wählen Sie Gestaffelt committen aus, um den Mergevorgang durchzuführen, nachdem Sie alle Mergekonflikte für alle Dateien behoben haben.

   

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. Checken Sie den Zielbranch im Bereich Branches im Fenster Git-Repository aus. Klicken Sie dann mit der rechten Maustaste auf den Quellbranch, und wählen Sie Mergen von <Quellbranch> in <Zielbranch> aus.

   

2. Visual Studio benachrichtigt Sie, wenn Git den Mergevorgang aufgrund von Konflikten angehalten hat. In diesem Fall können Sie entweder die Konflikte lösen oder den Mergevorgang abbrechen und zum Zustand vor dem Mergevorgang zurückkehren. Im Abschnitt Nicht gemergte Änderungen im Fenster Git-Änderungen wird die Liste der Dateien mit Mergekonflikten angezeigt. Doppelklicken Sie bei einer Datei mit Mergekonflikten in ihrem Inhalt auf die Datei, um sie im Merge-Editor zu öffnen.

   

3. Im Merge-Editor werden im Bereich Eingehend die Version der Quellbranchdatei, im Bereich Aktuell die Version der Zielbranchdatei und im Bereich Ergebnis die resultierende Mergedatei angezeigt. Um bestimmte Quell- oder Zielbranchänderungen anzuwenden, aktivieren Sie das Kontrollkästchen neben den in Konflikt stehenden Zeilen, die Sie beibehalten möchten. Sie können die Mergedatei auch direkt im Bereich Ergebnis bearbeiten. Wählen Sie Merge akzeptieren aus, nachdem Sie alle Mergekonflikte in der aktuellen Datei behoben haben. Wiederholen Sie diesen Schritt für jede Datei mit Inhaltskonflikten.

   

4. Klicken Sie für eine Datei, die in einem Branch bearbeitet und im anderen gelöscht wurde, mit der rechten Maustaste auf die Datei, und wählen Sie die gewünschte Branchaktion aus.

   

5. Geben Sie im Fenster „Git-Änderungen“ eine Commitnachricht ein, und wählen Sie Gestaffelt committen aus, um den Mergevorgang durchzuführen, nachdem Sie alle Mergekonflikte für alle Dateien behoben haben.

   

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 Git-Benutzeroberfläche von Team Explorer 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 Schnittstellen austauschbar verwenden.

1. Checken Sie den Zielbranch in der Ansicht Branches von Team Explorer aus. Klicken Sie dann mit der rechten Maustaste auf den Quellbranch, und wählen Sie Mergen aus aus.

   

2. Überprüfen Sie die Mergeoptionen, und klicken Sie dann auf Mergen.

   

3. Visual Studio benachrichtigt Sie, wenn Git den Mergevorgang aufgrund von Konflikten angehalten hat. In diesem Fall können Sie entweder die Konflikte lösen oder den Mergevorgang abbrechen und zum Zustand vor dem Mergevorgang zurückkehren. Um Konflikte zu lösen, wählen Sie Konflikte aus, um die Ansicht Konflikte auflösen zu öffnen.

   

4. In der Ansicht Konflikte auflösen werden die Dateien mit Mergekonflikten aufgelistet. Wählen Sie eine Datei in der Liste aus, um die Auflösungsoptionen für die betreffende Datei anzuzeigen.

   

5. Wählen Sie bei einer Datei mit Mergekonflikten in ihrem Inhalt Mergen aus, um sie im Merge-Editor zu öffnen.

   

6. Im Merge-Editor werden im Bereich Quelle die Version der Quellbranchdatei, im Bereich Ziel die Version der Zielbranchdatei und im Bereich Ergebnis die resultierende Mergedatei angezeigt. Um bestimmte Quell- oder Zielbranchänderungen anzuwenden, aktivieren Sie das Kontrollkästchen neben den in Konflikt stehenden Zeilen, die Sie beibehalten möchten. Sie können die Mergedatei auch direkt im Bereich Ergebnis bearbeiten. Wählen Sie Merge akzeptieren aus, nachdem Sie alle Mergekonflikte in der aktuellen Datei behoben haben. Wiederholen Sie diesen Schritt für jede Datei mit Inhaltskonflikten.

   

7. Wählen Sie für eine Datei, die in einem Branch bearbeitet und im anderen gelöscht wurde, die gewünschte Branchaktion aus.

   

8. Wählen Sie in der Ansicht Konflikte auflösen die Option Commit für Zusammenführung ausführen aus, nachdem Sie alle Mergekonflikte für alle Dateien aufgelöst haben.

   

9. Geben Sie in der Ansicht Änderungen von Team Explorer eine Commitnachricht ein, und klicken Sie auf Gestaffelt committen, um den Mergevorgang durchzuführen.

   

Git-Befehlszeile

Checken Sie den Zielbranch vor dem Zusammenführen eines Quellbranchs in einen Zielbranch aus. Verwenden Sie dann den Git-Mergebefehl, um den Quellbranch mit dem aktuellen lokalen Branch (Zielbranch) zusammenzuführen. Um mehrere Quellbranches in einem Zielbranch zusammenzuführen, trennen Sie die Namen des Quellbranches durch Leerzeichen.

git checkout <target branch>
git merge <source branch>

Tipp

Sie können auch git switch <branch name> verwenden, um zu einem Branch zu wechseln.

In einigen Szenarien kann es passieren, dass der Git-Mergebefehl mit einem Fehler fehlschlägt oder vor dem Abschluss angehalten wird.

Git-Nachricht	BESCHREIBUNG	Lösung
Ihre lokalen Änderungen an den folgenden Dateien würden durch Merge überschrieben...	Dieser Fehler weist darauf hin, dass ihr aktueller lokaler Branch mindestens eine Datei mit nicht committeten Änderungen enthält und diese Dateien von der Zusammenführung betroffen sind. Git generiert keinen Fehler für nicht committete Änderungen in Dateien, die nicht vom Mergevorgang betroffen sind.	Führen Sie für nicht committete Änderungen ein Commit oder Stash aus oder Verwerfen Sie nicht committete Änderungen , und wiederholen Sie dann den Mergevorgang.
Fehler bei der automatischen Zusammenführung; Konflikte beheben und das Ergebnis anschließend committen.	Mindestens eine Quellbranchänderung steht in Konflikt mit einer Zielbranchänderung. Git stoppt den Mergevorgang und wartet, bis Sie die Mergekonflikte aufgelöst haben.	Brechen Sie den Mergevorgang ab, indem Sie git merge --abort ausführen, oder lösen Sie alle Mergekonflikte auf, und führen Sie dann git merge --continue aus.

Tipp

Für den aktuellen Mergevorgang haben Sie folgende Möglichkeiten:

• Führen Sie git status aus, um die Dateien mit Mergekonflikten aufzulisten.
• Führen Sie git log --merge aus, um die in Konflikt stehenden Commits in den Quell- und Zielbranches aufzulisten.

Auflösen von Inhaltskonflikten

1. Öffnen Sie eine Datei in einem beliebigen Editor, um Widersprüche im Text anzuzeigen und zu lösen. Git hat eine Reihe von Markern hinzugefügt, um auf Widersprüche im Text hinzuweisen. Beispiel:

   <<<<<<< HEAD
   - Network controller
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switches
   =======
   - Network control
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switch
   >>>>>>> origin/main
   

   Der Text zwischen <<<<<<< und ======= ist die Zielbranchversion des widersprüchlichen Texts.
   Der Text zwischen ======= und >>>>>>> ist die Quellbranchversion des widersprüchlichen Texts.

2. Bearbeiten Sie die Datei, um die Widersprüche im Text zu lösen. Durch Entfernen der Marker für Mergekonflikte teilen Sie Git mit, dass Sie den Konflikt gelöst haben. Sie können z. B. den obigen Text (einschließlich der Konfliktmarker) ändern in:

   - Network controller
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switch
   

3. Führen Sie git add <filename> aus, um die Datei zu stagen, nachdem Sie alle Widersprüche im Text gelöst haben.

4. Wiederholen Sie die obigen Schritte für alle Dateien mit Inhaltskonflikten.

Auflösen von Konflikten aufgrund von gelöschten geänderten Dateien

Ein Konflikt mit gelöschten geänderten Dateien tritt auf, wenn dieselbe Datei in einem Branch bearbeitet, aber in einem anderen gelöscht wird. Entscheiden Sie für jede gelöschte geänderte Datei, welche Branchaktion Sie jeweils ausführen möchten. Verwenden Sie git add <filename>, um die geänderte Datei beizubehalten, oder git rm <filename>, um die Datei zu löschen.

Nächste Schritte

Freigeben eines Codes mithilfe von PushÄnderungen rückgängig machen

Verwandte Artikel

• Neu bei Git-Repositorys? Weitere Informationen
• Aktualisieren eines Code mit Fetch, Merge und Pull
• Speichern Ihrer Arbeit mit Commits