Che cos'è git stash e quando lo usi?

Question

Accepted Answer

**git stash** **salva temporaneamente le tue modifiche non committate** e ripristina la tua directory di lavoro a uno stato pulito — così puoi cambiare contesto (ad es. correggere un bug urgente su un altro branch) senza committare lavoro non finito, e poi ripristinare le modifiche in seguito.

## Il problema che stash risolve

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

## Usare 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` salva le modifiche e pulisce la directory di lavoro; `git stash pop` le ripristina in seguito (e rimuove lo stash). `apply` ripristina senza rimuovere.

## Scenario comune

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

## Opzioni utili

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

## Perché è importante

Comprendere `git stash` è prezioso per **gestire i cambi di contesto in modo pulito**, una situazione comune nel mondo reale, quindi è una conoscenza Git pratica e utile.

Il problema che risolve è frequente: sei nel mezzo del lavoro con modifiche non committate quando devi **cambiare contesto urgentemente** (correggere un bug in produzione su un altro branch, revisionare il codice di qualcuno, scaricare aggiornamenti) — ma cambiare branch con modifiche non committate è problematico (Git potrebbe rifiutarsi o portarle in modo disordinato), e committare lavoro non finito inquina la storia. **Stash** risolve elegantemente questo **salvando le tue modifiche da parte** e dandoti una directory di lavoro pulita per cambiare contesto, e poi **ripristinandole in seguito** quando ritorni — adatto esattamente allo scenario comune "ho bisogno di mettere da parte temporaneamente quello che sto facendo".

Comprendere i comandi principali (`git stash` per salvare, `git stash pop` per ripristinare-e-rimuovere, `git stash apply` per ripristinare-e-mantenere, `git stash list` per vedere gli stash) e il flusso di lavoro tipico (stash il lavoro in corso, cambia e gestisci l'attività urgente, cambia indietro e fai pop) è conoscenza pratica quotidiana per gestire le interruzioni.

Conoscere opzioni utili (`-u` per includere file non tracciati, visualizzare il contenuto dello stash) e che stash è per lo **stoccaggio temporaneo** (non un sostituto a lungo termine per commit/branch) riflette un uso appropriato.

Poiché i cambi di contesto e le interruzioni sono comuni nello sviluppo (bug urgenti, revisioni, necessità di una directory di lavoro pulita), e poiché stash fornisce un modo pulito e conveniente di mettere temporaneamente da parte il lavoro non committato e ripristinarlo in seguito, comprendere `git stash` — quello che risolve, i comandi, e il flusso di lavoro comune di cambio di contesto — è una conoscenza Git preziosa e praticamente rilevante per gestire la frequente necessità nel mondo reale di cambiare contesto senza committare lavoro non finito, uno strumento utile che facilita le interruzioni comuni dello sviluppo quotidiano.