Übersicht

git mergetool [-t <tool>] [--tool-help] [<file>...]

Beschreibung

Der git mergetool-Befehl startet ein externes Merge-Tool, um bei der Auflösung von Konflikten nach einem Merge, Rebase oder Cherry-Pick zu helfen, der mit Konflikten anhält. Häufige Tools sind vimdiff, meld, kdiff3, p4merge, opendiff und vscode. Sobald sie über merge.tool konfiguriert sind, öffnet das Ausführen von git mergetool jede konfliktbehaftete Datei im gewählten Tool und staget die Auflösung beim Speichern.

Die meisten modernen Editoren (VS Code, JetBrains-IDEs, Vim mit Fugitive) haben eingebaute Merge-UIs, die git mergetool überflüssig machen. Auf der Befehlszeile oder über SSH bleibt es dennoch ein essentielles Werkzeug für grafische oder dreispältige Konfliktauflösung.

Im täglichen Einsatz integriert sich git mergetool eng mit Shell-Aliasen, Editor-Plugins und Continuous Integration. Power-User fügen oft Aliase hinzu, die Flags kombinieren, die sie immer übergeben, oder wickeln den Befehl in Skripte, die Teamkonventionen durchsetzen. Die Ausgabeformatierung kann über Git-Config angepasst werden — Pretty-Formate, Farbschemata und Pager-Verhalten sind alle einstellbar. Wenn etwas schiefgeht, ist der erste Diagnoseschritt üblicherweise, den Befehl erneut mit GIT_TRACE=1 in der Umgebung auszuführen, was die zugrunde liegenden Plumbing-Aufrufe offenlegt. Für ungewöhnliche Situationen öffnet die --help-Ausgabe (git mergetool --help) die vollständige Manpage mit Details zu jeder Option, einschließlich solcher, die in alltäglichen Workflows selten verwendet werden, aber für Debugging oder Skripting im großen Maßstab essentiell sind.

Zu verstehen, wie git mergetool mit dem Rest von Gits Datenmodell interagiert — der Objektdatenbank, dem Index, Refs und dem Working Tree — zahlt sich aus. Jeder Befehl operiert auf einer Teilmenge dieser Stücke, und zu wissen, welche er berührt, hilft Ergebnisse vorherzusagen und sich von Fehlern zu erholen. Das Lesen der offiziellen Git-Dokumentation neben praktischer Übung in einem Wegwerf-Repository ist der schnellste Weg, die Nuancen zu verinnerlichen. Die meisten Produktionsprobleme mit Git rühren von einer von drei Ursachen: überraschendem Standardverhalten, partiellen Netzwerkoperationen oder dem Umschreiben bereits geteilter Historie. Ein funktionierendes mentales Modell der Nebenwirkungen von git mergetool hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
-t <tool>, --tool=<tool>	Verwendet ein bestimmtes Merge-Tool für diesen Lauf.
--tool-help	Listet die Merge-Tools auf, die Git kennt.
-y, --no-prompt	Fragt nicht vor dem Starten des Tools.
-g, --gui	Verwendet das GUI-Tool aus merge.guitool.
-O<file>	Verarbeitet Dateien in der in file aufgeführten Reihenfolge.

Beispiele

git config --global merge.tool meld
    # meld als Standard konfigurieren

    git mergetool
    # Das konfigurierte Tool auf jeder konfliktbehafteten Datei starten

    git mergetool -t vimdiff
    # Nur diesmal vimdiff verwenden

    git mergetool --tool-help
    # Liste der unterstützten Tools sehen

Häufige Fehler

Nach dem Auflösen mit git mergetool bleiben übrige .orig-Backupdateien, die das Verzeichnis verschmutzen. Deaktivieren Sie sie mit git config --global mergetool.keepBackup false. Eine weitere Falle: Das Starten eines GUI-Tools über SSH ohne X-Forwarding schlägt stillschweigend fehl. Konfigurieren Sie für Remote-Sitzungen ein konsolenfreundliches Tool (wie vimdiff).

Verwandte Befehle

git merge, git rebase, git config, git diff