Übersicht

git merge [--no-ff] [--squash] [--abort] [-s <strategy>] [<branch>]

Beschreibung

Der git merge-Befehl integriert Änderungen aus einem Branch in einen anderen. Standardmäßig erzeugt er einen "echten Merge"-Commit mit zwei Eltern und bewahrt die Topologie beider Historien. Wenn der Ziel-Branch ein strikter Vorfahre der Quelle ist, führt Git ein Fast-Forward durch, indem es einfach den Branch-Zeiger bewegt; übergeben Sie --no-ff, um immer einen Merge-Commit aufzuzeichnen.

Wenn dieselben Zeilen auf beiden Seiten geändert werden, hält Git mit einem Konfliktmarker an. Sie lösen manuell auf, dann führen Sie git add auf den Dateien aus und führen git commit aus (oder git merge --continue). Um aus einem laufenden Merge auszusteigen, verwenden Sie git merge --abort.

Im täglichen Einsatz integriert sich git merge 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 merge --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 merge 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 merge hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
--no-ff	Erstellt immer einen Merge-Commit, auch wenn Fast-Forward möglich ist.
--ff-only	Verweigert das Mergen, es sei denn, Fast-Forward ist möglich.
--squash	Kombiniert die gemergte Historie zu einem einzigen Commit auf dem Ziel-Branch.
--abort	Bricht einen laufenden Merge ab.
--continue	Setzt einen Merge nach Konfliktauflösung fort.
-s <strategy>	Wählt die Merge-Strategie (ort, recursive, resolve, octopus).
-X <option>	Übergibt strategiespezifische Option (z. B. ours, theirs).
--no-commit	Staged das Merge-Ergebnis, committet aber nicht.

Beispiele

git merge feature/login
    # Feature-Branch in den aktuellen Branch mergen

    git merge --no-ff release/1.2
    # Immer einen Merge-Commit erzeugen (bewahrt Topologie)

    git merge --abort
    # Einen Merge nach Konflikten abbrechen

    git merge -X theirs hotfix
    # Konflikte automatisch auflösen, indem die "ihre" Seite bevorzugt wird

Häufige Fehler

Konflikte in Eile auflösen und vergessen, Konfliktmarker (<<<<<<<) zu entfernen, hinterlässt kaputten Code im Commit. Führen Sie nach der Auflösung immer einen Build oder Tests aus. Eine weitere Falle ist stilles Fast-Forwarden, wenn Sie für die Nachverfolgbarkeit einen Merge-Commit wollten — verwenden Sie --no-ff. Schließlich erstellt --squash KEINEN Merge-Commit, sodass der Quell-Branch nicht als Elternteil aufgezeichnet wird.

Verwandte Befehle

git rebase, git mergetool, git pull, git cherry-pick