Mikä on git stash ja milloin sitä käytetään?

Question

Accepted Answer

**git stash** **tallentaa tilapäisesti uncommitted-muutoksesi** ja palauttaa working directoryn puhtaaksi tilaksi — jotta voit vaihtaa kontekstia (esim. korjata kiireellisen bugin toisella branchilla) ilman että commitoit keskeneräistä työtä, ja voit palauttaa muutokset myöhemmin.

## Ongelman jota stash ratkaisee

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

## Stashin käyttö

```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` tallentaa muutokset ja puhdistaa working directoryn; `git stash pop` palauttaa ne myöhemmin (ja poistaa stashin). `apply` palauttaa poistamatta.

## Tyypillinen skenaario

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

## Hyödylliset vaihtoehdot

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

## Miksi se on tärkeää

`git stash`:n ymmärtäminen on arvokasta **kontekstin vaihdoksien hallinnalle puhtaasti**, mikä on yleinen todellisen maailman tilanne, joten se on käytännöllinen Git-tieto.

Ongelma jonka se ratkaisee on yleinen: olet keskellä työtä uncommitted-muutoksilla kun joudut **vaihtamaan kontekstia kiireellisesti** (korjaa production-bugi toisella branchilla, tarkista jonkun koodia, vedä päivitykset) — mutta branchin vaihtaminen uncommitted-muutoksilla on ongelmallista (Git saattaa kieltäytyä tai kuljettaa ne epäsiististi), ja keskeneräisen työn committaaminen likaantaa historiaa. **Stash** ratkaisee tämän tyylikkäästi **asettamalla muutoksesi sivuun** ja antamalla sinulle puhtaan working directoryn kontekstin vaihdokselle, sitten **palauttamalla ne myöhemmin** kun palaat — täysin sopiva "minun täytyy pudottaa mitä teen tilapäisesti" skenaarioon.

Ydinkomennot (`git stash` tallentamiseen, `git stash pop` palauttamiseen-ja-poistamiseen, `git stash apply` palauttamiseen-ja-säilyttämiseen, `git stash list` stashin näkemiseen) ja tyypillinen työnkulku (stash kesken oleva työ, vaihda ja käsittele kiireellinen tehtävä, vaihda takaisin ja pop) on käytännöllinen päivittäinen tieto keskeytyksten hallinnassa.

Hyödyllisten vaihtoehtojen (`-u` seuraamattomien tiedostojen sisällyttämiseksi, stashin sisällön katseluun) tunteminen ja että stash on **tilapäiseen** tallennukseen (ei pitkäaikainen korvike committeille/brancheille) kuvastaa oikeaa käyttöä.

Koska kontekstin vaihdokset ja keskeytykset ovat yleisiä sovelluskehityksessä (kiireelliset bugit, tarkastukset, puhtaan working directoryn tarve), ja koska stash tarjoaa puhtaan ja kätevän tavan asettaa uncommitted-työ tilapäisesti sivuun ja palauttaa se myöhemmin, `git stash`:n ymmärtäminen — mitä se ratkaisee, komennot ja yleinen kontekstin vaihtamisen työnkulku — on arvokasta, käytännöllisesti relevanttia Git-tietoa kiireellisten keskeytykset käsittelemisen osalta ilman keskeneräisen työn committaamista, hyödyllinen työkalu joka silottaa päivittäisen kehityksen yleisiä keskeytyksiä.