A Git stash parancs rejtett lehetőségei

A modern szoftverfejlesztésben a Git a verziókezelés elengedhetetlen eszköze. Számtalan parancsot kínál a kódunk kezelésére, nyomon követésére és megosztására. Azonban van egy parancs, amelyet sok fejlesztő csak felületesen ismer, pedig hatalmas mértékben növelheti a hatékonyságot és a rugalmasságot: ez a git stash. A git stash nem csupán egy egyszerű ideiglenes mentés, hanem egy komplex eszköz, amelynek mélyebb megértése kulcsfontosságú lehet a kaotikusnak tűnő fejlesztési helyzetek kezelésében.

Miért van szükségünk a `git stash` parancsra?

Képzelj el egy szituációt: éppen egy új funkción dolgozol, és a kódod félig kész, tele van tesztelgetésekkel és félbehagyott módosításokkal. Hirtelen egy sürgős hibajavítás érkezik, amelyet azonnal meg kell oldani. Ilyenkor két lehetőséged van: vagy commitolod a félkész munkádat egy „WIP” (Work In Progress) üzenettel, szennyezve ezzel a commit történetet, vagy megpróbálod valahogy félretenni a változtatásokat. A git stash pont erre a problémára kínál elegáns megoldást. Lehetővé teszi, hogy ideiglenesen elmentsd a nem commitelt módosításaidat (a munkaterületet és a staging területet egyaránt), és visszaállítsd a repository-t egy tiszta állapotba, mintha semmit sem módosítottál volna. A félretett munkádat pedig később bármikor visszaállíthatod.

A `git stash` alapjai: Az első lépések a rugalmasság felé

A git stash parancs használatának megértése az alapvető funkciók ismeretével kezdődik.

A munkád elrejtése: `git stash` vagy `git stash save`

A legegyszerűbb és leggyakoribb módja a módosítások elrejtésének a git stash parancs. Ez alapértelmezetten elmenti a követett fájlokon végrehajtott, nem commitelt módosításokat, valamint a staging terület tartalmát. Az untracked (nem követett) fájlokat nem rejti el.

git stash

Ha egy későbbi azonosítás érdekében üzenettel szeretnéd ellátni a stash-t, használd a save alparancsot:

git stash save "Félbehagyott feature-X fejlesztés"

Ez egy sokkal átláthatóbbá teszi a stash listádat, különösen, ha több stash-t tartasz számon.

Elrejtett módosítások listázása: `git stash list`

Miután elrejtetted a munkádat, hogyan látod, miket rejtettél el? A git stash list parancs megjeleníti az összes elrejtett módosítást, a legújabb elöl, időrendi sorrendben.

git stash list

A kimenet valahogy így fog kinézni:

stash@{0}: On master: Félbehagyott feature-X fejlesztés
stash@{1}: On dev: Gyors kísérletezés

Itt a stash@{0} a legutóbbi, a stash@{1} az azelőtti elrejtett módosítás.

Módosítások visszaállítása: `git stash apply` és `git stash pop`

Amikor készen állsz a félretett munkád folytatására, két fő parancs áll rendelkezésedre:

git stash apply: Ez a parancs visszaállítja a stash-elt módosításokat a munkaterületre, de benne is hagyja a stash listában. Ez akkor hasznos, ha esetleg többször is szeretnéd alkalmazni ugyanazt a stash-t, vagy ha biztonsági okokból még nem szeretnéd véglegesen törölni.
```
git stash apply         # Visszaállítja a legújabb stash-t (stash@{0})
git stash apply stash@{1} # Visszaállítja a stash@{1} stash-t
```
git stash pop: Ez a parancs is visszaállítja a stash-elt módosításokat, de utána automatikusan törli azt a stash listából. Ez a leggyakoribb művelet, amikor befejezted a félretett munkát, és már nincs szükséged az ideiglenes mentésre.
```
git stash pop         # Visszaállítja és törli a legújabb stash-t (stash@{0})
git stash pop stash@{1} # Visszaállítja és törli a stash@{1} stash-t
```

Stash törlése: `git stash drop` és `git stash clear`

git stash drop: Ha egy adott stash-re már nincs szükséged, törölheted a listából.
```
git stash drop stash@{1} # Törli a stash@{1} stash-t
```
Ha nem adsz meg indexet, a stash@{0}-t (legújabbat) törli.
git stash clear: Ez a parancs összes stash-t törli a listából. Légy óvatos vele, mert ez egy visszafordíthatatlan művelet!
```
git stash clear
```

A `git stash` rejtett lehetőségei és haladó használata

Az alapok elsajátítása után merüljünk el a git stash kevésbé ismert, de rendkívül hasznos funkcióiban, amelyekkel valóban kiaknázhatod a benne rejlő potenciált.

Nem követett (untracked) fájlok elrejtése

Alapértelmezés szerint a git stash csak a követett (tracked) fájlok módosításait rejti el. Mi van akkor, ha vannak új, még nem hozzáadott fájljaid, amiket szintén el szeretnél rejteni? Erre való az -u vagy --include-untracked opció:

git stash -u

Ez elrejti a követett és a nem követett fájlok módosításait is.

Összes fájl elrejtése, beleértve az ignoráltakat is

Extrém esetekben, például ha egy gyors tisztítást szeretnél végezni a munkaterületen, és az összes fájlt, beleértve a .gitignore által ignoráltakat is el szeretnéd rejteni (pl. build output, log fájlok), használd az -a vagy --all opciót:

git stash -a

Ez egy ritkábban használt, de igen erőteljes opció.

Interaktív stash: Csak bizonyos módosítások elrejtése

Ez az egyik legkevésbé ismert, de leghasznosabb funkció. Képzeld el, hogy több különböző módosítást végeztél egy fájlon, de csak egy részüket szeretnéd elrejteni, a többit pedig commitolni. Az -p vagy --patch opcióval interaktívan választhatod ki, melyik „hunk”-ot (kódblokkot) szeretnéd stash-elni.

git stash push -p

A Git végigvezet a módosításokon, és minden blokknál megkérdezi, hogy el szeretnéd-e rejteni (y/n/a/d/g/j/s/e/?). Ez óriási rugalmasságot biztosít a munkád szegmentálásában.

Staging területen lévő módosítások elrejtése (stash –staged)

A git stash alapértelmezetten a munkaterületen lévő nem commitelt és a staging területen lévő módosításokat is elrejti. De mi van, ha csak a staging területen lévő módosításokat akarod elrejteni, a munkaterületen lévőket pedig érintetlenül hagyni?

git stash --staged

Ez a parancs elmenti a staging terület tartalmát egy stash-be, miközben a munkaterület módosításai érintetlenek maradnak. Ez hasznos lehet, ha már előkészítettél egy commit-ot, de mégis félre kell tenned ideiglenesen anélkül, hogy a még nem stage-elt változtatásaidat is „elpakolnád”.

Stash tartalmának megtekintése

Mielőtt alkalmaznál egy stash-t, érdemes lehet megnézni, pontosan mit is tartalmaz. A git stash show parancs erre szolgál:

git stash show          # Röviden összefoglalja a legújabb stash tartalmát
git stash show stash@{1} # Röviden összefoglalja a stash@{1} tartalmát
git stash show -p       # Megmutatja a teljes diffet (patch-et) a legújabb stash-hoz
git stash show -p stash@{1} # Megmutatja a teljes diffet a stash@{1} stash-hoz

A -p opcióval részletesebb képet kapsz, mintha egy git diff-et futtatnál.

Új ág létrehozása egy stash-ből: `git stash branch`

Ez egy rendkívül erőteljes funkció, amelyet sokan nem ismernek. Tegyük fel, hogy elkezdtél dolgozni egy funkción, stash-elted a módosításokat, majd folytattad a munkát egy másik ágon. Később rájössz, hogy a stash-elt munkád valójában egy új ágon kellett volna, hogy történjen. A git stash branch paranccsal létrehozhatsz egy új ágat abból a commitból, ahonnan a stash készült, alkalmazza rá a stash tartalmát, majd törli a stash-t a listáról.

git stash branch uj_feature_ag stash@{1}

Ez egy tiszta és biztonságos módja annak, hogy a félbehagyott munkát egy dedikált ágon folytasd.

Konfliktuskezelés a `git stash` parancsnál

Mint sok Git műveletnél, a stash-ek alkalmazásánál is előfordulhatnak konfliktusok. Ez akkor történik, ha a stash-elt módosítások ugyanazokat a sorokat érintik, mint a jelenlegi ágadon lévő módosítások. Ha konfliktus lép fel a git stash apply vagy git stash pop során, a Git jelezni fogja. Ebben az esetben a következőképpen járhatsz el:

Oldd meg a konfliktusokat: Nyisd meg a fájlokat, amelyekben konfliktus van (a Git jelöli a konfliktusos részeket `<<<<<<>>>>>>` jelölőkkel), és döntsd el, melyik verziót szeretnéd megtartani.
Add hozzá a feloldott fájlokat a staging területhez: Miután feloldottad a konfliktusokat, add hozzá a fájlokat a git add <fájlnév> paranccsal.
Folytasd a műveletet: Ha a git stash pop okozta a konfliktust, és feloldottad, a stash bejegyzés valószínűleg már törlődött. Ha a git stash apply után oldottad meg, akkor a stash még a listában marad.

A konfliktusok kezelése a git stash használatakor sem különbözik jelentősen a merge vagy rebase konfliktusok kezelésétől, így a már megszerzett tudásodat könnyedén alkalmazhatod itt is.

Gyakorlati tippek és bevált módszerek

A git stash parancs akkor a leghatékonyabb, ha tudatosan és fegyelmezetten használjuk. Íme néhány tipp:

Mindig adj üzenetet: A git stash save "Üzenet" használata elengedhetetlen, ha több stash-t tartasz számon. Így könnyen beazonosíthatod, mit is rejtettél el.
Rendszeresen töröld a felesleges stash-eket: Ne hagyd, hogy felhalmozódjanak a már nem releváns stash-ek. A git stash drop és a git stash clear segítenek rendet tartani.
Használd kontextusváltáshoz: Ha sürgősen egy másik ágra kell váltanod egy hibajavítás miatt, a stash a tökéletes megoldás a félkész munkád elrejtésére.
Kísérletezéshez: Ha csak gyorsan ki akarsz próbálni egy ötletet anélkül, hogy commitolnál, stash-eld a jelenlegi munkád, teszteld az új ötletet, majd dobd el, vagy vedd elő a stash-t.
rebase vagy merge előtt: Mielőtt egy bonyolult rebase vagy merge műveletbe kezdenél, érdemes elrejteni a nem commitelt módosításaidat, hogy elkerüld a nem kívánt mellékhatásokat.

Mikor ne használd a `git stash` parancsot?

Bár a git stash rendkívül hasznos, nem minden helyzetre ez a legjobb megoldás:

Hosszú távú tárolás: A stash-ek ideiglenesek. Ha hosszú távon szeretnél megtartani valamit, ami még nincs kész, inkább hozz létre egy új, ideiglenes ágat (pl. feature/wip-valami), és commitolj oda. Ez sokkal robusztusabb megoldás.
Megosztás másokkal: A stash-ek lokálisak, nem részei a repository történetének, és nem oszthatók meg könnyen más fejlesztőkkel. Ha meg szeretnél osztani egy félkész munkát, szintén hozz létre egy ágat és push-old fel.
Komplex átmeneti állapotok: Ha a munkád annyira összetett, hogy a stash tartalmának visszaállítása több konfliktust eredményezne, mint amennyit megér, érdemesebb lehet inkább egy ideiglenes commit-ot létrehozni egy elágazáson.

A `git stash` és más Git parancsok összehasonlítása

Fontos megérteni, hogy a git stash nem az egyetlen módja az ideiglenes állapotok kezelésének. Íme néhány alternatíva és azok felhasználási területei:

git commit --amend: Ha csak az utolsó commit-ot szeretnéd módosítani, például elfelejtettél hozzáadni egy fájlt, vagy elírtad az üzenetet. Ez a parancs az utolsó commit-hoz adja hozzá a módosításokat.
git checkout -b <új_ág>: Ha a félbehagyott munkád valójában egy új ág alapja, vagy úgy gondolod, hogy érdemes lehet egy dedikált ágat létrehozni neki, ez a parancs a megfelelő választás. Itt commitolhatod a munkádat anélkül, hogy a fő ágat szennyeznéd.
git worktree: Haladóbb felhasználóknak, akik több feladaton dolgoznak párhuzamosan, és minden feladathoz egy teljesen izolált munkaterületre van szükségük. A git worktree lehetővé teszi, hogy ugyanahhoz a repository-hoz több munkakönyvtár is tartozzon, mindegyik egy külön ágon. Ez egy nagyon tiszta megoldás, de bonyolultabb a beállítása, mint egy egyszerű stash.

Összefoglalás

A git stash parancs sokkal több, mint egy egyszerű „félreteszem” gomb. Egy komplex, rugalmas eszköz, amely segít rendet tartani a fejlesztési folyamatban, lehetővé teszi a gyors kontextusváltást és támogatja a kísérletezést anélkül, hogy a Git repository történetét felesleges commitokkal terhelnéd. Az alapvető parancsoktól a fejlettebb opciókig, mint az interaktív stash-elés vagy az ág létrehozása egy stash-ből, a git stash a hatékony Git munkafolyamat kulcsfontosságú eleme lehet. Fedezd fel rejtett lehetőségeit, és tedd még gördülékenyebbé a mindennapi fejlesztési munkádat!