Tu es en plein milieu d’une modification, et tu dois changer de branche en urgence ? Ou tu veux annuler tes changements, mais pas définitivement ? C’est le rôle de git stash.
Ce que fait git stash
git stash prend tes modifications non commitées (préparées avec git add ou non), les met de côté pour plus tard, et remet ta copie de travail propre, comme au dernier commit.
Le problème
Tu es sur la branche test, et tu as modifié trois fichiers. Maintenant :
- soit tu dois basculer sur
developpour une autre tâche ; - soit tu veux retirer ces modifications pour l’instant, sans les perdre.
Sans stash, il faudrait annuler tes changements à la main, fichier par fichier, et les refaire plus tard. Avec stash, c’est une commande.
Mettre de côté
git stash
# Saved working directory and index state WIP on test: …
git status
# nothing to commit, working tree clean
Toutes tes modifications sont enregistrées dans la pile des stash, et ta branche est propre. Tu peux changer de branche tranquillement.
Les nouveaux fichiers (non suivis par Git) ne sont pas mis de côté par défaut. Pour les inclure :
git stash -u.
Voir la liste des stash
git stash list
# stash@{0}: WIP on test: …
# stash@{1}: WIP on test: …
Le plus récent est toujours stash@{0}.
Récupérer ses modifications : apply ou pop
# Réappliquer le dernier stash, en le GARDANT dans la liste
git stash apply
# Réappliquer le dernier stash, et le SUPPRIMER de la liste
git stash pop
| Commande | Réapplique les modifications | Garde le stash dans la liste |
|---|---|---|
git stash apply | ✅ | ✅ |
git stash pop | ✅ | ❌ |
Pour un stash précis plutôt que le dernier, indique son index :
git stash apply stash@{1}
Supprimer un stash : drop
# Supprimer le dernier stash
git stash drop
# Supprimer un stash précis
git stash drop stash@{1}
Donc, deux façons de faire la même chose :
git stash applypuisgit stash drop;- ou directement
git stash pop.
À retenir
git stash est très utile quand on travaille sur plusieurs branches en même temps : tu mets ton travail en cours de côté, tu règles l’urgence ailleurs, puis tu reprends exactement où tu en étais.
Exercice · Une urgence en plein travail
Tu modifies index.html et tu as créé un nouveau fichier contact.html, quand on te demande une correction urgente sur main. Mets tout de côté, change de branche, puis reviens et récupère ton travail.
Voir la solution
git stash -u # -u : inclut le nouveau fichier contact.html
git checkout main
# … correction, commit, push …
git checkout feature/contact
git stash pop
Sans -u, contact.html (non suivi par Git) serait resté dans ton dossier et t’aurait suivi sur main.
La suite
Au prochain chapitre : comment faire un commit parfait.
Ceci est le chapitre 5 du cours Git en pratique. Suis la série pour apprendre à utiliser Git au quotidien et en équipe.