So lösen Sie Git-Merge-Konflikte in der Befehlszeile und in einem Drei-Wege-Editor

Um Zusammenführungskonflikte in Git zu lösen, öffnen Sie jede Datei, die Git als Konflikt meldet, entscheiden Sie, wie der Code zwischen den Markierungen <<<<<<<, ======= und >>>>>>> aussehen soll, löschen Sie die Markierungen, stellen Sie die Datei mit git add bereit und schließen Sie mit git commit (oder git merge --continue) ab. Um stattdessen zurückzukehren, führen Sie git merge --abort aus. Dieser Leitfaden durchläuft diese Schleife in der Befehlszeile, dann in einem visuellen Drei-Wege-Editor und endet mit den Gewohnheiten, die Konflikte seltener und einfacher rückgängig zu machen machen. Nehmen Sie an der kostenlosen Lektion Aktiven Vorgang fortsetzen, überspringen oder abbrechen teil, um die Auswahlmöglichkeiten zu üben, die Ihnen eine angehaltene Zusammenführung, Rebase oder Cherry-Pick bietet.

Die visuellen Beispiele verwenden GitTree, den Git-Client, den wir für macOS, Windows und Linux erstellen. Es führt das auf Ihrem Computer installierte Git aus. Klicken und Tippen führen also zum gleichen Ergebnis. Die GitTree Feature-Liste bietet ein umfassenderes Bild.

Was für ein Zusammenführungskonflikt in Git eigentlich ist

Git führt Zeile für Zeile unter Verwendung von drei Versionen jeder Datei zusammen: die Basis (der letzte Commit, den beide Zweige gemeinsam nutzen), unsere (Ihr aktueller Zweig, HEAD) und ihre (der eingehende Zweig, MERGE_HEAD). Wenn nur eine Seite eine Region geändert hat, übernimmt Git diese Änderung. Wenn beide Seiten die gleichen Zeilen unterschiedlich geändert haben, stoppt Git, schreibt beide Versionen in die Datei und überlässt die Entscheidung Ihnen.

Das Gleiche kann in git pull, git rebase, git cherry-pick, git revert und git stash pop passieren. Der Fix ist identisch; nur der letzte Befehl unterscheidet sich. git status beschriftet jeden in Konflikt stehenden Pfad:

• beide geändert: Beide Zweige haben die gleichen Zeilen geändert. Dies ist der häufigste Fall.
• Von uns gelöscht / von ihnen gelöscht: Eine Seite hat die Datei gelöscht und die andere Seite hat sie geändert, Sie behalten also die geänderte Datei oder bestätigen den Löschvorgang.
• beide hinzugefügt: Jeder Zweig hat eine andere Datei im selben Pfad erstellt.

So beheben Sie Zusammenführungskonflikte in der Befehlszeile

1. Suchen Sie die in Konflikt stehenden Dateien

Git listet die Konflikte auf, sobald die Zusammenführung stoppt, und git status behält die Liste bei, bis Sie fertig sind. git diff --name-only --diff-filter=U gibt nur die nicht zusammengeführten Pfade aus.

$ git merge feature/login
Auto-merging src/auth.ts
CONFLICT (content): Merge conflict in src/auth.ts
Automatic merge failed; fix conflicts and then commit the result.

$ git status
On branch main
You have unmerged paths.

Unmerged paths:
  (use "git add <file>..." to mark resolution)
        both modified:   src/auth.ts

2. Lesen Sie die Konfliktmarkierungen

Alles außerhalb der Markierungen verschmolz sauber. Der Block nach <<<<<<< HEAD ist Ihr aktueller Zweig, der Block vor >>>>>>> feature/login ist der eingehende und die Zeile ======= trennt sie.

export const retries = 3;
<<<<<<< HEAD
export const timeout = 45;
=======
export const timeout = 60;
>>>>>>> feature/login
export const debug = false;

Zwei Versionen reichen oft nicht aus, um eine Entscheidung zu treffen. Legen Sie Gits zdiff3-Konfliktstil einmal fest, und jeder Konflikt zeigt auch die Basis nach einer |||||||-Zeile an:

$ git config --global merge.conflictStyle zdiff3

<<<<<<< HEAD
export const timeout = 45;
||||||| 556e564
export const timeout = 30;
=======
export const timeout = 60;
>>>>>>> feature/login

Jetzt können Sie sehen, dass main das Timeout von 30 auf 45 und den Feature-Zweig auf 60 erhöht hat: Entscheiden Sie, welchen Wert das Produkt benötigt, und nicht, welcher Zweig gewinnt.

3. Bearbeiten Sie die Datei und markieren Sie sie als gelöst

Schreiben Sie den gewünschten Code (eine Seite, die andere, eine Mischung oder etwas Neues) und löschen Sie jede Markierungszeile. Lassen Sie Git vor der Bereitstellung nach Resten suchen, da ein versehentlich begangener Streuner ======= ein klassischer fehlerhafter Build ist.

$ git diff --check          # lists any leftover conflict markers
$ git add src/auth.ts
$ git commit                # or: git merge --continue

Wenn die Version der gesamten Datei auf einer Seite richtig ist, nehmen Sie sie direkt. Damit Git bei der Zusammenführung für jedes in Konflikt stehende Stück eine Seite bevorzugt, starten Sie die Zusammenführung stattdessen mit git merge -X ours oder git merge -X theirs. Änderungen, die keinen Konflikt verursachen, kommen dennoch aus beiden Zweigen.

$ git checkout --ours -- src/auth.ts     # keep the current branch's version
$ git checkout --theirs -- src/auth.ts   # keep the incoming version
$ git add src/auth.ts

4. Beenden Sie den Vorgang

Wenn jede Datei bereitgestellt ist, fahren Sie mit dem fort, was gestoppt wurde: git commit (oder git merge --continue), git rebase --continue, git cherry-pick --continue oder git revert --continue. Ein Rebase kann bei einem späteren Commit erneut gestoppt werden; Wiederholen Sie die Schleife.

Lösen Sie Zusammenführungskonflikte in einer GUI: ein Drei-Wege-Git-Konfliktlöser

Markierungen sind für einen Zwei-Linien-Konflikt in Ordnung. Bei einem Dutzend Konflikten in einer langen Datei ist ein GUI-Konfliktlöser schneller und es ist viel schwieriger, Fehler zu machen. Ein gutes Git-Tool zum Zusammenführen von Konflikten zeigt alle drei Versionen zusammen an, lässt Sie Konflikt für Konflikt entscheiden und verweigert das Speichern, solange Markierungen verbleiben.

In GitTree wird bei einer Zusammenführung, die angehalten wird, ein Banner mit der Anzahl der Konflikte und einer Liste der in Konflikt stehenden Dateien angezeigt. Öffnen Sie eines und der Editor nimmt das gesamte Fenster ein: oben die aktuellen und eingehenden Zweige nebeneinander, jeder mit seinem Zweignamen beschriftet, und darunter die Ausgabe, die Datei, wie sie gespeichert wird.

• Pro Konflikt: Nehmen Sie die aktuelle Seite, die eingehende Seite, beide oder keines von beiden oder wählen Sie jeweils einzelne Zeilen aus.
• Bearbeiten Sie die Ausgabe manuell für alles, was die Schaltflächen nicht abdecken.
• Basis anzeigen, um den gemeinsamen Vorfahren anzuzeigen (Git schreibt ihn, wenn merge.conflictStyle diff3 oder zdiff3 ist).
• Auswahl rückgängig machen, um Ihre Entscheidungen rückgängig zu machen.
• Gelöschte Dateien: Wenn eine Seite eine Datei gelöscht hat, hat die andere Seite sie geändert. Behalten Sie die Datei dieser Seite oder bestätigen Sie den Löschvorgang.

GitTree speichert kein Ergebnis, das noch Markierungslinien enthält. Es kann die Datei auch in Ihrem externen Zusammenführungstool öffnen: VS Code, Cursor, JetBrains IDEs, Beyond Compare, Meld, KDiff3, P4Merge, WinMerge, ein benutzerdefiniertes Programm oder Gits eigenes merge.tool. Wenn das Tool geschlossen wird, ohne die Datei aufzulösen, bleibt die Datei im Konflikt.

Sagen Sie Zusammenführungskonflikte voraus, bevor Sie zusammenführen

Seit Git 2.38 führt git merge-tree --write-tree eine Zusammenführung im Speicher durch, ohne Ihren Arbeitsbaum oder Index zu lesen oder zu schreiben und ohne einen Commit durchzuführen. Mit --name-only werden die Dateien aufgelistet, bei denen es zu Konflikten kommen würde; Der Exit-Status ist 1, wenn Konflikte vorliegen, und 0, wenn die Zusammenführung sauber wäre.

$ git fetch
$ git merge-tree --write-tree --name-only HEAD origin/main
0d708adc4a836d088802870278cb1f3daf06355f
src/auth.ts

Auto-merging src/auth.ts
CONFLICT (content): Merge conflict in src/auth.ts

GitTree führt diese Vorschau für Sie aus: Im Zusammenführungsdialog wird das vorhergesagte Ergebnis angezeigt, bevor Sie es bestätigen. Nach jedem Abruf vergleicht es außerdem Ihren Branch mit seinem Upstream- und dem Basis-Branch (Haupt- oder Master-Zweig, es sei denn, Sie legen einen anderen fest) und zeigt neben dem Filialnamen eine Warnung an, z. B. „Würde in zwei Dateien mit dem Hauptzweig in Konflikt geraten“. Ein zweiter Hinweis markiert Dateien, die Sie ändern, sodass sich auch andere abgerufene, nicht zusammengeführte Zweige ändern.

Bei beiden Prüfungen wird nur das verwendet, was Sie bereits abgerufen haben: Es wird nichts abgerufen, zusammengeführt oder geändert, um sie zu berechnen, und nichts verlässt Ihren Computer. Beides kann in den Einstellungen deaktiviert werden.

Konfliktlösungen mit git rerere wiederverwenden

Rerere steht für „Aufgezeichnete Auflösung wiederverwenden“. Wenn diese Option aktiviert ist, zeichnet Git jeden Konflikt und die Art und Weise auf, wie Sie ihn gelöst haben. Wenn der gleiche Konflikt erneut auftritt, beispielsweise bei einem wiederholten Rebase eines langlebigen Zweigs oder einer von Ihnen wiederholten Zusammenführung, schreibt Git Ihre frühere Lösung in die Datei.

$ git config --global rerere.enabled true
$ git rerere forget src/auth.ts   # drop a recorded resolution that was wrong

Git lässt das wiederverwendete Ergebnis zur Überprüfung nicht bereitgestellt, es sei denn, rerere.autoUpdate ist festgelegt. In GitTree verfügen die Repository-Einstellungen über die Schalter Aufgezeichnete Auflösungen wiederverwenden (rerere) und Wiederverwendete Auflösungen bereitstellen für diese Git-Optionen; Die Konfliktansicht kennzeichnet eine wiederverwendete Lösung und Lösung vergessen löscht eine falsche.

So brechen Sie eine Zusammenführung in Git ab oder brechen sie ab

Um eine Zusammenführung abzubrechen, die aufgrund von Konflikten gestoppt wurde, führen Sie git merge --abort aus. Ein Rebase, Cherry-Pick oder Revert hat seinen eigenen Abbruch:

$ git merge --abort
$ git rebase --abort
$ git cherry-pick --abort
$ git revert --abort

Die eigene Dokumentation von Git warnt davor, dass git merge --abort nicht immer nicht festgeschriebene Änderungen wiederherstellen kann, die Sie zu Beginn der Zusammenführung vorgenommen haben. Commit oder Stash vor dem Zusammenführen, und beim Abbruch muss nur die Commit-Arbeit wiederhergestellt werden.

In GitTree erklärt Abort Merge (oder Abort Rebase, Cherry-Pick, Revert) zunächst, dass Git den Zweig, den Index und die Arbeitskopie von vor dem Vorgang wiederherstellt und die bisher vorgenommenen Auflösungen verwirft. GitTree speichert alles, was durch den Abbruch verloren geht, ob inszeniert oder nicht, in Wiederherstellungs-Snapshots, sodass Sie es durch Rückgängig wiederherstellen können.

So machen Sie eine Zusammenführung rückgängig, nachdem Sie sie festgeschrieben haben

Was zu tun ist, hängt davon ab, ob Sie die Zusammenführung vorangetrieben haben:

# Not pushed yet, right after the merge:
$ git reset --hard ORIG_HEAD     # also discards uncommitted changes
$ git reset --merge ORIG_HEAD    # keeps uncommitted changes

# Already pushed:
$ git revert -m 1 <merge-commit> # a new commit that reverses it

Bei einer Zusammenführung wird der vorherige Tipp Ihres Zweigs in ORIG_HEAD gespeichert. Durch das Zurücksetzen wird die Zusammenführung also entfernt, es sei denn, ein späteres Zurücksetzen oder Rebase verschiebt ORIG_HEAD. Sobald andere die Zusammenführung haben, kehren Sie stattdessen zurück. Durch das Rückgängigmachen einer Zusammenführung wird Git mitgeteilt, dass Sie diese Änderungen niemals möchten: Durch das erneute Zusammenführen dieses Zweigs werden sie nicht wiederhergestellt, es sei denn, Sie machen das Zurücksetzen rückgängig.

Wählen Sie in GitTree das erste übergeordnete Element der Zusammenführung (den Commit, auf dem sich Ihr Zweig zuvor befand) im Diagramm aus und wählen Sie im Commit-Menü einen Soft-, Mixed- oder Hard-Reset aus, wobei jeder mit dem beschriftet ist, was er behält. GitTree erstellt Snapshots von 19 Arten von Vorgängen, bevor sie ausgeführt werden, einschließlich Zurücksetzungen, sodass „Rückgängig“ das Zurücksetzen rückgängig machen kann und die Reflog-Ansicht ältere Zustände wiederherstellt. Die Anleitung zum Rückgängigmachen eines Zurücksetzens, Rebases oder Commits behandelt die Wiederherstellung ausführlich.

So verhindern Sie die meisten Zusammenführungskonflikte

• Halten Sie die Zweige klein und kurzlebig. Je länger zwei Zweige auseinanderlaufen, desto mehr Linien berühren sie.
• Bringen Sie den Basiszweig oft ein, nicht einmal am Ende.
• Trennen Sie die Formatierung von der Logik. Vereinbaren Sie einen Formatierer und führen Sie die Neuformatierung der gesamten Datei selbstständig durch.
• Generieren Sie Sperrdateien neu, anstatt sie manuell zusammenzuführen. Übernehmen Sie eine Seite und führen Sie dann Ihren Paketmanager erneut aus.
• Zdiff3 einschalten und einmal wiederholen. Zwei Befehle, nachhaltiger Nutzen.
• Vor der Integration festschreiben oder stashen, damit jeder Abbruch und jedes Rückgängigmachen exakt ist.

Möchten Sie zunächst an einem sicheren Repository üben? Die kostenlose Lektion Diverged Branches zusammenführen und beide übergeordneten Zweige verifizieren in den Git-Tutorials führt Sie durch eine echte Zusammenführung. Wägen Sie immer noch das Terminal gegen eine GUI ab? Git GUI vs. Befehlszeile vergleicht beide ehrlich.

GitTree verfügt über einen kostenlosen Plan, der alle Git-Funktionen abdeckt, einschließlich privater Repositories, und Nour, der KI-Assistent, wird mit GitTree Pro geliefert (siehe Preise); Es benötigt Git 2.39 oder neuer und ein GitTree-Konto, um sich anzumelden. Holen Sie es sich für macOS, Windows oder Linux oder sehen Sie sich alle Installationsprogramme auf der GitTree Download-Seite an. Am Ubuntu 22.04 zuerst Git aktualisieren. Sie stecken in einem hartnäckigen Konflikt fest? Fragen Sie den GitTree-Support.