Stash: legg uferdig arbeid til side

Den interaktive leksjonen trenger JavaScript. Teksten under er hele leksjonen.

Etter leksjonen kan du

• legge uferdige endringer til side med git stash push -m og ta dem tilbake med git stash pop anvende
• forklare forskjellen på git stash pop og git stash apply, og når du trenger -u forstå
• velge mellom en stash og en WIP-commit på en egen branch ut fra hvor lenge avbruddet varer og om arbeidet må videre til en annen maskin vurdere

Forstå: Når du blir avbrutt

Du er midt i en endring på branchen feature. README er halvveis skrevet, og du har en ny fil med ideer. Så kommer beskjeden: noe på main må fikses nå, men arbeidet ditt er ikke klart for en commit.

Prøver du å bytte til main nå, kan Git nekte. README ser annerledes ut på main, og byttet ville skrevet over den uferdige teksten din. Git kaster aldri ulagret arbeid uten at du ber om det.

git stash push tar endringene i sporede filer og legger dem på en hylle ved siden av historikken. De sporede filene blir like siste commit igjen. Med -m gir du stashen en melding, så du vet hva den inneholder senere.

Se på grafen: hylla er en egen commit med merkelappen stash@{0}. Den har to foreldre. Den ene er commiten du sto på. Den andre er en liten commit som tar vare på staging-området. Ingen branch flyttet seg.

Se på arbeidsmappen: ideas.txt ble liggende. Usporede filer blir ikke med i en stash, med mindre du legger til -u.

Når du er tilbake, legger git stash pop endringene inn igjen og fjerner oppføringen hvis det gikk uten konflikt. Merkelappen stash@{0} forsvinner, og stash-commitene blir spøkelser. git stash apply legger også endringene inn, men beholder oppføringen til du kjører git stash drop.

En stash er lokal og blir ikke med i en vanlig push. Den har et nummer, ikke et navn, og numrene forskyves: stasher du igjen, blir stash@{0} til stash@{1}. Til en lang pause committer du heller arbeidet som WIP på en egen branch. Den har et navn og kan pushes.

Se demo: Avbrudd, rettelse og tilbake igjen

Vi står på feature med uferdig arbeid. I kortformatet betyr M endret og to spørsmålstegn usporet. README er endret, og ideas.txt er ny.

$ git status --short

Nå prøver vi å bytte til main. Git nekter og sier hvorfor: den lokale endringen i README ville blitt overskrevet. Git foreslår selv å committe eller stashe.

$ git switch main

Vi legger arbeidet til side med en melding. Se på grafen: en stash-commit med merkelappen stash@{0} dukker opp ved siden av feature. README er tilbake til siste commit.

$ git stash push -m "WIP search filters"

git stash list viser hylla. Den nyeste oppføringen ligger øverst som stash null, med branchen og meldingen din. Det er den samme stash@{0} som i grafen.

$ git stash list

Nå prøver vi byttet igjen. Stashen blir hengende ved feature, der den ble laget. Men hvor havner ideas.txt?

$ git switch main

Her gjør vi den hastende rettelsen og committer den. Grafen får en ny commit på main.

$ echo "Contact: team@example.com" >> README.md && git commit -am "Add contact line"

Rettelsen er ute av verden. Vi går tilbake til feature.

$ git switch feature

Til slutt tar vi arbeidet tilbake. pop legger endringene inn igjen og fjerner oppføringen fordi det gikk uten konflikt. Merkelappen stash@{0} forsvinner fra grafen, og README er endret igjen, akkurat der du slapp.

$ git stash pop

Oppgaver

1. Legg de uferdige endringene til side med en beskrivende melding.
2. Bytt til main.
3. Ta det uferdige arbeidet tilbake og fjern oppføringen fra stash-listen.

Øv: Overfør: alt til side, og en bedre plan

Nytt repository på main. README er endret, og todo.txt er en ny fil. Ingen demo denne gangen.

Oppgaver

1. Legg bort alt det uferdige arbeidet, også den nye filen todo.txt, slik at arbeidsmappen blir helt ren.
2. Ta arbeidet tilbake, men behold oppføringen i stash-listen i tilfelle noe går galt.
3. Jobben ble større enn ventet. Lagre arbeidet som en commit på en ny branch wip-todo i stedet, og fjern den overflødige stash-oppføringen.

Sjekk deg selv: Hent det fram igjen

Du lager den nye filen new.txt, kjører git add new.txt og så git stash push. Blir new.txt lagt bort?

• Nei, nye filer krever -u
• Ja, den er sporet fordi den ligger i staging-området
• Bare den stagede kopien; filen blir liggende i arbeidsmappen

Hva er forskjellen på git stash pop og git stash apply?

• pop fjerner oppføringen når endringene er lagt inn uten konflikt; apply lar den stå
• pop tar bare tilbake den nyeste stashen; apply tar tilbake alle
• apply overskriver arbeidsmappen; pop slår endringene sammen

Det er fredag. Featuren er halvferdig, og på mandag skal du jobbe videre med den fra en annen maskin. Hva gjør du?

• git stash push -u, og så git push
• En WIP-commit på en egen branch, og så push branchen
• En WIP-commit rett på main, og så git push

Repetisjon fra «Angre i filene»: I stedet for å stashe kjører du git restore README.md på en uferdig endring du aldri har staget, committet eller stashet. Kan du få den tilbake etterpå?

• Ja, med git stash pop
• Ja, fra reflogen
• Nei, endringen er borte for godt

Vanlige misforståelser

• «Stash tar med alt.» Uten -u blir usporede filer liggende i arbeidsmappen.
• «Stash er en backup.» Stash finnes bare i ditt lokale repository, blir ikke med i en vanlig git push, og en droppet stash er vanskelig å finne igjen.
• «git stash pop og git stash apply er det samme.» pop fjerner oppføringen når endringene ble lagt inn uten konflikt; apply lar den stå.

$ git stash push -m "WIP search filters"
Saved working directory and index state On feature: WIP search filters
$ git log --oneline --graph stash@{0}
*   aa05d36 On feature: WIP search filters
|\  
| * 167af41 index on feature: 88dbfe3 Start search feature
|/  
* 88dbfe3 Start search feature
* 227577f Initial snapshot

$ git stash show -p
diff --git a/README.md b/README.md
index 5793643..ea67787 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,3 @@
 Welcome
 Feature: search
+Search supports filters

$ git stash pop
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
...
The stash entry is kept in case you need it again.

$ git stash branch search-filters stash@{1}
Switched to a new branch 'search-filters'
...
Dropped stash@{1} (aa05d36ebb5dca462ca44e0d15313d1e1bff66eb)

$ git fsck --unreachable
...
unreachable commit 71170d9e92aa9dc024f199860e70bad17c592d26
unreachable commit dcb6cf266285a1ae2eddd115659790c56acc7039
$ git log --oneline --no-walk 71170d9 dcb6cf2
71170d9 index on main: a69bcbf Initial snapshot
dcb6cf2 On main: two kinds
$ git stash apply dcb6cf2