Übersicht

git pull [--rebase] [--ff-only] [<remote> [<branch>]]

Beschreibung

Der git pull-Befehl ist eine Kurzform für git fetch, gefolgt von einem Integrationsschritt (standardmäßig Merge, optional Rebase). Er aktualisiert Ihren aktuellen Branch, um Upstream-Änderungen einzubeziehen. Viele Teams bevorzugen es, pull.rebase = true zu konfigurieren oder git pull --rebase zu verwenden, um die Historie linear zu halten.

Wenn Ihr Branch und der Upstream divergiert sind, kann git pull einen Merge-Commit erzeugen. Mit --ff-only schlägt der Pull fehl, anstatt einen Merge zu erstellen — nützlich, wenn Sie sicher sein wollen, dass Ihr lokaler Branch nur zurückliegt, nicht divergiert.

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

Häufige Optionen

Option	Beschreibung
--rebase	Rebaset lokale Commits auf gefetchte Änderungen.
--ff-only	Nur Fast-Forward; abbrechen, falls ein Merge nötig wäre.
--no-ff	Erstellt immer einen Merge-Commit.
--all	Fetcht von allen Remotes vor der Integration.
--autostash	Stasht lokale Änderungen vor dem Pull und popt sie danach.
--prune	Entfernt veraltete Remote-Tracking-Branches als Teil des Fetch.

Beispiele

git pull
    # Standard: Fetch und Merge vom konfigurierten Upstream

    git pull --rebase origin main
    # Lokale Commits auf das neueste origin/main rebasen

    git pull --ff-only
    # Verweigert das Erstellen eines Merge-Commits

    git config --global pull.rebase true
    # Rebase als Standard für jeden Pull setzen

Häufige Fehler

Pullen mit uncommitted Änderungen kann dazu führen, dass Git sich weigert zu mergen. Entweder committen, stashen oder --autostash verwenden. Pullen auf einen Branch, der divergiert ist, erzeugt oft unerwartete Merge-Commits. Verwenden Sie --ff-only als Sicherheitsnetz oder rebasen Sie explizit.

Verwandte Befehle

git fetch, git merge, git rebase, git push