Çfarë është git stash dhe kur e përdorni atë?

Question

Accepted Answer

**git stash** në mënyrë të përkohshme **ruan ndryshimet tuaja të pa-komituara** dhe kthen direktoriun tuaj të punës në një gjendje të pastër — në mënyrë që të mund të ndrroni kontekst (p.sh. rregulloni një bug urgjent në një degë tjetër) pa komituar punë të papërfunduar, më pas mund t'i rivendosni ndryshimet më vonë.

## Problemi që zgjidh stash-i

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

## Përdorimi i stash-it

```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` ruan ndryshimet dhe pastroi direktoriun e punës; `git stash pop` i rivendos ato më vonë (dhe heq stash-in). `apply` i rivendos pa hequr.

## Skenari i zakonshëm

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

## Opsione të dobishme

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

## Përse ka rëndësi

Kuptimi i `git stash` është i vlefshëm për **trajtimin e ndërrimeve të kontekstit në mënyrë të pastër**, një situatë e zakonshme në botën reale, prandaj është njohuri praktike e dobishme të Git-it.

Problemi që zgjidh është i shpeshtë: ju jeni në mes të punës me ndryshime të pa-komituara kur keni nevojë të **ndrroni kontekst me urgjencë** (rregulloni një bug në prodhim në një degë tjetër, rishikoni kodin e dikujt, tërhiqni përditësimet) — por ndërrimi i degëve me ndryshime të pa-komituara është problematik (Git mund të refuzojë ose t'i mbajë ato në mënyrë të çarmatosur), dhe komitimi i punës së papërfunduar ndotet historinë. **Stash** zgjedh këtë në mënyrë elegante duke **ruajtur ndryshimet tuaja anash** dhe duke ju dhënë një direktori pune të pastër për të ndrruar kontekste, më pas **duke i rivendosur ato më vonë** kur ktheheni — pikërisht përshtat skenarin e zakonshëm "Kam nevojë ta lë atë që po bëj për një moment".

Kuptimi i komandave themeltare (`git stash` për të ruajtur, `git stash pop` për të rivendosur-dhe-hequr, `git stash apply` për të rivendosur-dhe-mbajtur, `git stash list` për të parë stash-et) dhe fluksi tipik (stash-oni punën në progres, ndrroni dhe trajtoni detyrën urgjente, ndrroni prapa dhe pop-ini) është njohuri praktike e përditshme për menaxhimin e ndërprerjeve.

Dija e opsioneve të dobishme (`-u` për të përfshirë skedarëve të patërkohësuar, shikimi i përmbajtjes së stash-it) dhe se stash-i është për **ruajtje të përkohshme** (jo zëvendësim afatgjatë për komitim/degë) pasqyron përdorimin e duhur.

Meqenëse ndérrimet e kontekstit dhe ndërprerjeve janë të zakonshme në zhvillimin e software-it (bug-et urgjente, rishikimet, nevojën për një direktori pune të pastër), dhe meqenëse stash ofroi një mënyrë të pastër dhe të përshtatshme për të vënë anash përkohësisht punën e pa-komituar dhe për ta rivendosur më vonë, kuptimi i `git stash` — çfarë zgjidh atë, komandat, dhe fluksin e zakonshëm të ndërrimit të kontekstit — është njohuri praktike dhe relevante të Git-it për trajtimin e nevojës së zakonshme në botën reale për ndërrimin e kontekstit pa komituar punë të papërfunduar, një mjet të dobishëm që zbutë ndërprerjeve të zakonshme të zhvillimit të përditshëm.