git stash – Tutorial

Nun kannst du Änderungen vornehmen, neue Commits erstellen, Branches wechseln und alle anderen Git-Funktionen nutzen. Wenn du schließlich bereit bist, wendest du deinen Stash wieder an.

Beachte, dass das in deinem Git-Repository ein lokaler Stash ist und deine Stashes beim Pushen nicht an den Server übermittelt werden.

Zuvor aufbewahrte Änderungen kannst du mit git stash pop erneut anwenden:

Wenn du deinen Stash poppst, werden die Änderungen aus deinem Stash entfernt und erneut auf deine Arbeitskopie angewendet.

Du kannst aber auch die Änderungen erneut auf deine Arbeitskopie anwenden und sie weiterhin in deinem Stash aufbewahren. Hierfür gibst du git stash apply ein:

Das ist nützlich, wenn du dieselben gestashten Änderungen auf mehrere Branches anwenden willst.

Nachdem du nun die Grundlagen zum Stashing kennst, solltest du dir noch über einen kleinen Nachteil von git stash bewusst werden: In den Standardeinstellungen bewahrt Git keine Änderungen an u nicht verfolgten oder ignorierten Dateien im Stash auf.

Durch Hinzufügen der Option -u (oder --include-untracked) werden mit git stash auch deine nicht verfolgten Daten gestasht:

Die Änderungen ignorierter Dateien können miteinbezogen werden, indem du die Option -a (oder --all) an den Befehl git stash anfügst.

Zur Bereitstellung von mehr Kontextinformationen ist es sinnvoll, deine Stashes mithilfe von git stash save "Nachricht"mit einer Beschreibung zu versehen:

Standardmäßig wird mit git stash pop der zuletzt erstellte Stash erneut angewendet: stash@{0}

Du kannst aber wählen, welcher Stash erneut angewendet werden soll, indem du dessen Kennung als letztes Argument anfügst, z. B.:

Du kannst aber auch die Option -p (oder --patch) angeben, um den vollständigen Diff eines Stashes anzuzeigen:

Wenn du auf das ? klickst, erhältst du eine vollständige Liste der Hunk-Befehle. Diese hier sind besonders nützlich:

Es gibt zwar keinen ausdrücklichen Befehl zum "Abbrechen", aber mit Strg-C (SIGINT) kannst du den Stash-Prozess abbrechen.

Hiermit werden ein neuer Branch auf Basis des Commits, auf dem du deinen Stash erstellt hast, ausgecheckt und dann die aufbewahrten Änderungen eingefügt.

Oder du löschst alle deine Stashes mit:

Je nachdem, was du stashst, werden in einem einzigen git stash-Vorgang entweder zwei oder drei neue Commits durchgeführt. Im Beispiel oben gibt es folgende Commits:

• stash@{0}, ein neuer Commit zum Speichern der verfolgten Dateien, die sich beim Ausführen von git stash in deiner Arbeitskopie befanden
• Der erste übergeordnete Commit von stash@{0}, d. h. der vorher bereits bestehende Commit, der sich am HEAD befand, als du git stash ausgeführt hast
• Der zweite Parent von stash@{0}, ein neuer Commit, der den Index von dem Zeitpunkt repräsentiert, als du git stash ausgeführt hast
• Der dritte Parent von stash@{0}, ein neuer Commit, der die unverfolgten Dateien repräsentiert, die sich in deiner Arbeitskopie befanden, als du git stash ausgeführt hast. Der dritte Parent wird nur unter folgenden Voraussetzungen erstellt:
  • Deine Arbeitskopie enthält unverfolgte Dateien und
  • du hast die Option --include-untracked oder --all an git stash angefügt.

So codierst du mit git stash deinen Arbeitsbaum und deinen Index in Commits um:

• Vor dem Stashing kann dein Arbeitsbaum Änderungen an verfolgten, nicht verfolgten und ignorierten Dateien enthalten. Einige dieser Änderungen befinden sich ggf. auch im Index (in der Staging-Umgebung).

• Bei der Verwendung von git stash werden alle Änderungen an verfolgten Dateien als zwei neue Commits in deinem DAG (gerichteten azyklischen Graphen) kodiert: ein Commit für die Änderungen, die sich nicht in der Staging-Umgebung befinden und ein Commit, für die Änderungen, die sich in der Staging-Umgebung (Index) befinden. Die spezielle Referenz refs/stash wird aktualisiert, um auf diese Commits zu verweisen.

• Mit der Option --include-untracked kannst du auch alle Änderungen an nicht verfolgten Dateien in einen weiteren Commit umkodieren.

• Die Option --all schließt Änderungen an ignorierten Dateien genauso wie Änderungen an unverfolgten Dateien im selben Commit ein.

Wenn du git stash pop ausführst, werden die Änderungen aus den obigen Commits zur Aktualisierung deiner Arbeitskopie und deines Index verwendet und der hervorgeholte Commit wird aus dem Stash-Reflog entfernt. Beachte, dass die hervorgeholten Commits nicht sofort gelöscht werden, sondern zu Kandidaten für die nächste Bereinigung werden.