Co je git stash a kdy se používá?

Question

Accepted Answer

**git stash** dočasně **uloží vaše necommitované změny** a vrátí váš pracovní adresář do čistého stavu — takže můžete přepnout kontext (například opravit naléhavou chybu na jiné větvi) bez toho, abyste commitovali nedokončenou práci, a změny si později obnovíte.

## Problém, který stash řeší

```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.
```

## Používání 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` uloží změny a vyčistí pracovní adresář; `git stash pop` je později obnoví (a odstraní stash). `apply` obnoví bez odstranění.

## Běžný scénář

```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
```

## Užitečné volby

```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.
```

## Proč to záleží

Pochopení `git stash` je cenné pro **čisté zvládání přepínání kontextu**, běžné situaci v reálném světě, takže je to užitečné praktické znalosti Gitu.

Problém, který řeší, je časté: jste uprostřed práce s necommitovanými změnami, když musíte urgentně **přepnout kontext** (opravit produkční chybu na jiné větvi, zkontrolovat něčí kód, stáhnout aktualizace) — ale přepnutí větví s necommitovanými změnami je problematické (Git se může odmítnout nebo je přenese neslušně), a commitování nedokončené práce znečišťuje historii. **Stash** elegantně řeší tento problém tím, že **uloží vaše změny stranou** a dá vám čistý pracovní adresář pro přepnutí kontextu, poté **je později obnoví**, když se vrátíte — přesně podle scénáře "Musím na chvíli přestat s tím, na čem pracuji".

Pochopení základních příkazů (`git stash` pro uložení, `git stash pop` pro obnovení-a-odstranění, `git stash apply` pro obnovení-a-uchování, `git stash list` pro zobrazení stashů) a typické pracovní procedury (stash nedokončené práce, přepnutí a zvládnutí naléhavého úkolu, přepnutí zpět a pop) je praktické každodenní znalosti pro správu přerušení.

Znalost užitečných voleb (`-u` pro zahrnutí nesledovaných souborů, zobrazení obsahu stashu) a fakt, že stash je určen pro **dočasné** uložení (ne jako dlouhodobá náhrada za commity/větve), odráží správné používání.

Proto, že přepínání kontextu a přerušení jsou v programování běžná (naléhavé chyby, kontroly, potřeba čistého pracovního adresáře) a protože stash poskytuje čistý a pohodlný způsob, jak dočasně odložit necommitovanou práci a později ji obnovit, pochopení `git stash` — co řeší, příkazy a pracovní postup přepínání kontextu — je cenné, prakticky relevantní znalosti Gitu pro zvládání časté potřeby přepnout kontext bez commitování nedokončené práce, užitečný nástroj, který usnadňuje běžná přerušení každodenního vývoje.