Co to jest git stash i kiedy go używasz?

Question

Accepted Answer

**git stash** tymczasowo **zapisuje Twoje niezatwierdzone zmiany** i przywraca katalog roboczy do czystego stanu — dzięki czemu możesz zmienić kontekst (np. naprawić pilny błąd na innej gałęzi) bez zatwierdzania niedokończonej pracy, a następnie przywrócić zmiany później.

## Problem, który rozwiązuje stash

```text
You're mid-work with uncommitted changes, but need to switch context urgently:
  → switch branches? Git may refuse (uncommitted changes would conflict) or carry
    them along messily
  → commit half-done work? No — it's not ready (pollutes history)
→ STASH saves your changes aside, giving you a clean working directory to switch.
```

## Używanie stash

```bash
git stash                      # save uncommitted changes; working dir becomes clean
git stash push -m "message"    # stash with a description
git stash list                 # list stashes (stash@{0}, stash@{1}, ...)

git stash pop                  # RESTORE the latest stash AND remove it from the list
git stash apply                # restore but KEEP it in the stash list
git stash apply stash@{1}      # apply a specific stash
git stash drop stash@{0}       # delete a stash
git stash clear                # remove all stashes
```

`git stash` zapisuje zmiany i czyści katalog roboczy; `git stash pop` przywraca je później (i usuwa stash). `apply` przywraca bez usuwania.

## Typowy scenariusz

```bash
# working on a feature, but an urgent bug needs fixing on main:
git stash                      # save the in-progress feature work
git switch main
# ... fix the urgent bug, commit, push ...
git switch feature
git stash pop                  # restore the feature work and continue
```

## Przydatne opcje

```text
git stash -u        → also stash UNTRACKED files (not just tracked changes)
git stash show -p   → see what's in a stash
→ Stash is for TEMPORARY storage — not a substitute for commits/branches long-term.
```

## Dlaczego to ważne

Zrozumienie `git stash` jest wartościowe dla **czystego radzenia sobie ze zmianami kontekstu**, typową sytuacją w rzeczywistym świecie, dlatego jest to przydatna praktyczna wiedza na temat Gita.

Problem, który rozwiązuje, jest częsty: jesteś w trakcie pracy z niezatwierdzonym zmianami, gdy musisz **pilnie zmienić kontekst** (naprawić błąd produkcyjny na innej gałęzi, przejrzeć kod kogoś innego, pobrać aktualizacje) — ale przełączanie się między gałęziami z niezatwierdzonym zmianami jest problematyczne (Git może się weźwać lub przenosić je niezgrabnie), a zatwierdzanie niedokończonej pracy zaśmieca historię. **Stash** elegancko rozwiązuje to poprzez **zapisanie Twoich zmian na bok** i danie Ci czystego katalogu roboczego do zmiany kontekstu, a następnie **przywrócenie ich później** gdy się wrócisz — dokładnie pasujące do typowego scenariusza "Muszę tymczasowo porzucić to, nad czym pracuję".

Zrozumienie podstawowych poleceń (`git stash` do zapisania, `git stash pop` do przywrócenia-i-usunięcia, `git stash apply` do przywrócenia-i-zachowania, `git stash list` do zobaczenia stashów) i typowego przepływu pracy (stash niedokończonej pracy, przełączenie się i obsłużenie pilnego zadania, przełączenie się z powrotem i pop) to praktyczna codzienna wiedza do zarządzania przerwaniami.

Znajomość przydatnych opcji (`-u` aby uwzględnić nowe pliki, przeglądanie zawartości stasha) i zrozumienie, że stash jest przeznaczony do **tymczasowego** przechowywania (nie na długoterminową substytucję commitów/gałęzi) odzwierciedla prawidłowe użycie.

Ponieważ zmiany kontekstu i przerwania są częste w rozwoju (pilne błędy, przeglądy, potrzeba czystego katalogu roboczego), a stash zapewnia czysty, wygodny sposób tymczasowego odsunięcia niezatwierdzonej pracy i przywrócenia jej później, zrozumienie `git stash` — co rozwiązuje, polecenia i typowy przepływ pracy zmiany kontekstu — jest wartościową, praktycznie istotną wiedzą na temat Gita do obsługi częstej rzeczywistej potrzeby zmiany kontekstu bez zatwierdzania niedokończonej pracy, niezawodnego narzędzia, które usprawnia typowe przerwania codziennego rozwoju.