Sicher stashen: Nachrichten, unversionierte Dateien und Stash-Branches

Ziel

Nicht committete Arbeit kurzzeitig parken, etwa um zu pullen oder einen anderen Branch anzusehen, ohne sie zu verlieren und ohne die Stash-Liste zu einem Friedhof unbeschrifteter „WIP“-Einträge werden zu lassen.

Voraussetzungen

Wissen, was ein Stash ist: Die Dokumentation beschreibt ihn als gewöhnliches Commit-Objekt; der neueste wird unter refs/stash gespeichert, ältere finden sich im Reflog dieser Referenz und werden als stash@{0}, stash@{1} und so weiter angesprochen. Unversionierte und ignorierte Dateien werden nur einbezogen, wenn dies ausdrücklich verlangt wird.

Schritte

1. Erwägen, gar nicht zu stashen. Dauert die Unterbrechung voraussichtlich länger als eine Stunde, auf einem temporären Branch committen (git switch -c wip/topic && git commit -am wip) oder eine zweite Arbeitskopie (Worktree) verwenden; beides ist gewöhnliche Historie und kann nicht versehentlich verworfen werden.
2. Mit Nachricht stashen: git stash push -m "half-done: rate limiter tests". Die Standardbeschriftung „WIP on <branch>“ sagt einen Tag später nichts mehr aus.
3. Über unversionierte Dateien entscheiden. -u / --include-untracked fügt neue Dateien hinzu; -a / --all nimmt auch ignorierte Dateien mit, was Build-Verzeichnisse und Caches miterfassen kann. Nur die gemeinten Pfade stashen: git stash push -m "..." -- src/limiter.py.
4. --keep-index verwenden, wenn der bereits gestagte Teil fertig ist und nur der Rest verschwinden soll, und --patch, um Hunks interaktiv auszuwählen.
5. Um die Arbeit zurückzuholen, zuerst git stash apply, dann die Tests laufen lassen und erst danach git stash drop. pop erledigt beides auf einmal; die Dokumentation weist darauf hin, dass der Eintrag bei einem durch Konflikte fehlschlagenden Apply nicht entfernt wird – die zweistufige Form macht den Zustand also so oder so eindeutig.
6. Hat sich der Branch so weit entwickelt, dass apply Konflikte erzeugt, git stash branch <name> [<stash>] verwenden: Das erstellt einen Branch beim Commit, von dem der Stash stammt, wendet den Stash dort konfliktfrei an und entfernt den Eintrag.
7. git stash list am Ende der Woche durchsehen und Überholtes entfernen; git stash show -p stash@{2} zeigt, was ein Eintrag enthält.

Erwartetes Ergebnis

Jeder Eintrag in git stash list hat eine erklärende Nachricht, kein Stash trägt stillschweigend generierte Dateien mit sich, und ein fehlgeschlagenes apply kostet den Stash nie.

Grenzen und Prüfbasis

Stashes sind lokal und werden nicht gepusht. git stash clear entfernt alle Einträge, und die Dokumentation warnt, dass sie danach unter Umständen nicht mehr wiederherstellbar sind; verwaiste Commits lassen sich manchmal mit git fsck finden, aber das ist eine Rettungsmassnahme, kein Arbeitsablauf. Die Schritte sind ein aus der zitierten Dokumentation abgeleitetes Vorgehen.