Merge-Konflikte manuell lösen

Willkommen in der Welt der Merge-Konflikte! Keine Sorge: Sie sind ein normaler Bestandteil der Zusammenarbeit mit Git. Ein Merge-Konflikt tritt auf, wenn Git nicht automatisch bestimmen kann, wie Änderungen aus zwei verschiedenen Branches zusammengeführt werden sollen.

Das geschieht meistens, wenn zwei Branches dieselben Zeilen in derselben Datei auf unterschiedliche Weise ändern oder wenn ein Branch eine Datei löscht, die in einem anderen Branch geändert wurde.

Git ist beim automatischen Mergen der meisten Änderungen äußerst leistungsfähig. Bei Mehrdeutigkeiten benötigt Git jedoch menschliche Unterstützung. Hier sind häufige Szenarien:

• Dieselbe Zeile, unterschiedliche Änderungen: Zwei Personen bearbeiten genau dieselbe Codezeile auf unterschiedliche Weise.
• Eine Person löscht, eine andere ändert: Ein Branch löscht eine Datei, während ein anderer Branch sie ändert.
• Umbenennen gegenüber Ändern: Eine Datei wird in einem Branch umbenannt und in einem anderen geändert.

Wenn ein Merge-Konflikt auftritt, schließt Git den Merge nicht automatisch ab. Stattdessen hält Git den Vorgang an und teilt Ihnen mit, in welchen Dateien Konflikte vorliegen. Sie sehen dann eine Meldung wie diese:

Nachdem ein automatischer Merge fehlgeschlagen ist, befindet sich Ihr Repository in einem „merging“-Zustand. Mit git status können Sie sehen, in welchen Dateien Konflikte vorliegen. Diese Dateien werden als „unmerged paths“ aufgelistet.

Git fügt direkt in die Dateien mit Konflikten spezielle Markierungen ein, um Ihnen die problematische Stelle zu zeigen. Anhand dieser Markierungen können Sie die verschiedenen Code-Versionen erkennen:

• <<<<<<< HEAD: Kennzeichnet den Beginn der Änderungen Ihres aktuellen Branches.
• =======: Trennt die Änderungen der beiden Branches.
• >>>>>>> branch-name: Kennzeichnet das Ende der Änderungen des eingehenden Branches.

Sehen wir uns ein Beispiel an. Stellen Sie sich vor, Sie haben eine Datei hello.txt. Ihr main-Branch hat sie in „Hello from main“ geändert, während ein feature-Branch dieselbe Zeile in „Greetings from feature“ geändert hat. Beim Mergen von feature in main sieht die Datei so aus:

Ihre Aufgabe ist es, die Datei mit dem Konflikt (z. B. hello.txt) in Ihrem Texteditor zu öffnen. Bearbeiten Sie die Datei anschließend manuell, entfernen Sie die Konflikt-Markierungen und wählen Sie den gewünschten Inhalt aus. Sie können Teile kombinieren, eine Version auswählen oder etwas völlig Neues schreiben.

Wenn wir in unserem Beispiel mit hello.txt beide Nachrichten behalten möchten, könnten wir die Datei so bearbeiten:

Nachdem Sie die Datei manuell bearbeitet und alle Konflikt-Markierungen entfernt haben, müssen Sie Git mitteilen, dass Sie den Konflikt gelöst haben. Dazu fügen Sie die Datei mit git add zum Staging-Bereich hinzu.

Wiederholen Sie diesen Vorgang für jede Datei, die von git status als „unmerged path“ aufgeführt wird.

Nachdem alle Dateien mit Konflikten zum Staging hinzugefügt wurden, kann der Merge committet werden. Git stellt normalerweise eine standardmäßige Nachricht für den Merge-Commit bereit, die Sie übernehmen oder ändern können. Dieser abschließende Commit beendet den Merge-Vorgang.

Sie haben einen Merge-Konflikt erfolgreich aufgelöst. Testen wir nun Ihr Verständnis des nächsten wichtigen Schritts nach der manuellen Bearbeitung einer Datei mit Konflikten.

Sie haben gelernt, wie Sie Merge-Konflikte manuell auflösen! Das ist eine grundlegende Fähigkeit für alle Entwicklerinnen und Entwickler.

• Konflikte treten auf, wenn Git Änderungen nicht automatisch zusammenführen kann.
• git status zeigt nicht zusammengeführte Dateien an.
• Konfliktmarker (<<<<<<<, =======, >>>>>>>) zeigen voneinander abweichenden Code.
• Bearbeiten Sie die Dateien manuell, entfernen Sie die Marker und wählen Sie den endgültigen Inhalt aus.
• Stagen Sie die aufgelösten Dateien mit git add.
• Schließen Sie den Merge mit git commit ab.

Übung macht den Meister! Konflikte können anfangs einschüchternd wirken, aber mit diesen Schritten werden Sie sie sicher beherrschen.