7.3 Git Tools - Stashen en opschonen

Om de werking te laten zien, ga je naar je project en begint te werken aan een aantal bestanden en mogelijk stage je een van de wijzigingen. Als je git status gebruikt, kan je je vuile status zien:

Nu wil je naar een andere branch omschakelen, maar je wilt hetgeen waar je aan hebt gewerkt nog niet committen; dus ga je de wijzigingen stashen. Om een nieuwe stash op de stapel (stack) te duwen, roep je git stash of git stash push aan:

Je nu zien dat je werk directory schoon is:

Op dit moment kan je eenvoudige branches switchen en werk elders doen; je wijzigingen zijn bewaard op je stack. Om te zien welke stashes je bewaard hebt, kan je git stash list gebruiken:

In dit voorbeeld, zijn er twee stashes eerder bewaard, dus je hebt toegang tot drie verschillende gestashde werken. Je kunt die ene die je zojuist gestasht hebt weer afspelen door het commando zoals getoond in de help uitvoer van het oorspronkelijke stash commando: git stash apply. Als je een van de oudere stashes wilt afspelen, kan je deze aangeven door de naam gebruiken, zoals dit: git stash apply stash@{2}. Als je geen stash aangeeft, gebruikt Git de meest recente stash en probeert deze af te spelen:

Je kunt zien dat Git de bestanden weer wijzigt die je teruggedraaid had toen je de stash bewaarde. In dit geval had je een schone werk directory toen je de stash probeerde af te spelen en je probeerde deze af te spelen op dezelfde branch als waarvan je het had bewaard. Maar het hebben van een schone werk directory en deze op dezelfde branch af te spelen zijn niet nodig om een stash succesvol af te spelen. Je kunt een stash op de ene branch bewaren, later overschakelen naar een andere branch en daar de wijzigingen proberen opnieuw af te spelen. Je kunt ook gewijzigde en ongecommitte bestanden in je werkdirectory hebben als je een stash afspeelt — Git geeft je merge conflicten als iets niet meer netjes kan worden toegepast.

De wijzigingen aan je bestanden werden opnieuw gemaakt, maar het bestand dat je voorheen gestaged had wordt niet opnieuw gestaged. Om dat te doen, moet de het git stash apply commando met een --index optie gebruiken om het commando te vertellen om de gestagede wijzigingen opnieuw af te spelen. Als je deze variant had gebruikt, zou je je oorspronkelijke situatie terug hebben gekregen:

De apply optie probeert alleen het gestashde werk opnieuw af te spelen — je blijft het behouden op je stack. Om het weg te halen, kan je git stash drop gebruiken met de naam van de stash die moet worden verwijderd:

Je kunt ook git stash pop gebruiken om de stash af te spelen en dan meteen te verwijderen uit je stack.

Er zijn een paar stash varianten die ook handig kunnen zijn. De eerste variant die redelijk populair is, is de --keep-index optie bij het git stash commando. Dit vertelt Git niet alleen alle gestagede inhoud mee te nemen in de te creeren stash, en tegelijkertijd het in de index te laten.

Een ander veel voorkomende toepassing van stash is om de niet getrackte bestanden te stashen zowel als de getrackte. Standaard zal git stash alleen tracked bestanden die gewijzigd en staged zijn opslaan. Als je --include-untracked of `-u gebruikt zal git ook alle niet getrackte bestanden die je gemaakt hebt stashen. Echter, niet getrackte bestanden in de stash betrekken zal nog steeds niet expliciet ignored bestanden meenemen; om ignored bestanden mee te nemen, gebruik je --all (of alleen -a).

Als laatste, als je de --patch optie gebruikt, zal Git niet alles wat is gewijzigd stashen maar zal in plaats je daarvan interactief vragen welk van de wijzigingen je wilt stashen en welke je in je werk directory wilt behouden.

Als je wat werk gestashed hebt, dit daar een tijdje bewaard, en doorgaat op de branch van waaruit je het werk gestasht hebt, kan je een probleem krijgen bij het weer afspelen hiervan. Als het afspelen een bestand wil wijzigen wat je daarna weer gewijzigd hebt, zal je een merge conflict krijgen en zul je het moeten proberen op te lossen. Als je een makkelijker manier wilt om de gestashde wijzigingen weer te testen, kan je git stash branch <nieuwe branchnaam> gebruiken, wat een nieuwe branch voor je aanmaakt, checkt de commit uit waar je op stond toen je je werk stashde, speelt de wijzigingen af op je werk daar en verwijdert de stash als het succesvol heeft kunnen toepassen:

Dit is een mooie manier om gestashde werk eenvoudig terug te halen en eraan te werken in een nieuwe branch.

Als laatste wil je misschien bepaald werk of sommige bestanden in je werk directory stashen, maar dit simpelweg verwijderen. Dit is waar het git clean commando voor bedoeld is.

Een simpele reden voor het opschonen van je werk directory kan zijn dat het verwijderen van restjes zijn die zijn gegenereerd door merges of andere tools of om bouw-producten te verwijderen om een nette build te maken.

Je moet wel erg voorzichtig zijn met dit commando, het is namelijk gemaakt om bestanden van je werk directory weg te halen die niet worden getracked. Als je je later bedenkt, is er vaak niet mogelijk om de inhoud van die bestanden terug te halen. Een veiligere optie is om git stash --all te gebruiken om alles weg te halen, en dit alles in een stash te bewaren.

Aangenomen dat je de overbodige bestanden wilt verwijderen of je werk directory wilt opschonen, kan je dat doen met git clean. Om alle ongetrackte bestanden uit je werk directory te verwijderen kan je het git clean -f -d commando aanroepen, die alle bestanden verwijdert en ook alle subdirectories die leeg zijn geraakt als gevolg hiervan. De -f betekent forceer of "doe dit nou maar echt", en is verplicht als de Git configuratie variabele clean.requireForce niet expliciet op false gezet is.

Als je ooit wilt zien wat het zou gaan doen, kan je het commando met de --dry-run (of -n) optie aanroepen, wat “doe een generale repetitie en vertel me wat je zou hebben verwijderd”.

Stamdaard zal het git clean commando alleen ongetrackte bestanden verwijderen die niet genegeerd worden. Elk bestand waarvan de naam overeenkomt met een patroon in je .gitignore of andere negeer (ignore) bestanden zullen niet verwijderd worden. Als je ook deze bestanden wilt verwijderen, bijvoorbeeld om alle .o bestanden te verwijderen die zijn gegenereerd tijdens een build zodat je een compleet schone build kunt doen kan je een -x toevoegen aan het opschoon-commando.

Als je niet weet wat het git clean commando zal gaan doen, roep deze dan altijd eerst aan met een -n voor de zekerheid voordat je de -n in een -f wijzigt en het definitief doet. Een alternatief voor het voorzichtig uitvoeren van dit proces is om het aan te roepen met de -i of “interactive” optie.

Dit zal het opschoon-commando in een interactieve modus aanroepen.

Op deze manier kan je alle bestanden een voor een afgaan of bepaalde patronen voor verwijdering aangeven.