Übersicht

git stash push -p -m <msg> -- <pathspec>
git stash branch <newbranch> [<stash>]
git stash create
git stash store -m <msg> <sha>

Beschreibung

Über git stash push und git stash pop hinaus bietet die Stash-Maschinerie mächtige Funktionen für fortgeschrittene Workflows. Sie können bestimmte Pfade stashen, bestimmte Hunks mit -p stashen, einen Branch aus einem Stash wiederherstellen, der mit dem aktuellen Zustand kollidiert, oder sogar ein Stash-Objekt erstellen, ohne es auf dem Stack zu speichern (es später mit eigener Nachricht speichern).

Intern ist jeder Stash ein Merge-Commit zwischen WIP-on-branch (dem Working Tree) und index-on-branch (den gestagten Änderungen), mit der Branch-Spitze als Elternteil. Diese Struktur erlaubt es stash branch und stash apply, den exakten Zustand zu rekonstruieren.

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

Häufige Optionen

Unterbefehl / Option	Beschreibung
push -p	Stash interaktiv ausgewählter Hunks.
push -- <pathspec>	Stash nur angegebener Pfade.
--keep-index	Stash, behält aber das bereits Gestagte.
--no-keep-index	Setzt Index beim Stashen zurück (Standard).
branch <name>	Stellt Zustand auf einem frischen Branch wieder her.
create	Erstellt einen Stash-Commit, speichert ihn aber nicht.
store -m	Legt einen vorhandenen Commit auf den Stack.

Beispiele

git stash push -p -m "WIP: only refactor changes" -- src/refactor/
    # Nur bestimmte Pfade interaktiv stashen

    git stash --keep-index -m "Test pre-staged"
    # Verifizieren, dass gestagte Änderungen Tests bestehen, mit WIP zur Seite gelegt

    git stash branch fix-from-stash stash@{2}
    # Einen Stash wiederbeleben, der nicht mehr sauber anwendbar ist

    SHA=$(git stash create "checkpoint")
    git stash store -m "manual checkpoint" "$SHA"
    # Programmatische Stash-Erstellung

Häufige Fehler

Während eines Merges oder Rebases zu stashen mischt Zustände und verwirrt den Stack. Vermeiden Sie das. Langlebige Stashes überleben ihren Kontext — überprüfen Sie sie regelmäßig. --keep-index ist großartig, um gestagte Änderungen zu verifizieren, aber der resultierende Stash enthält sowohl gestagten als auch ungestagten Inhalt, was überraschen kann.

Verwandte Befehle

git stash, git commit --fixup, git worktree, git restore