stashing

Comment apprivoiser le stashing Git sans jamais perdre ton travail ?

Tu codes tranquillement sur ta feature, et soudain un hotfix urgent débarque sur ta branche principale. Ton working directory est en chantier, et tu n’as pas envie de faire un commit bâclé juste pour basculer ailleurs. Le stashing est exactement l’outil que tu cherches, ma belle.

Pourtant, beaucoup de développeuses hésitent à l’utiliser par peur de perdre leur travail au passage. Bonne nouvelle : bien maîtrisé, le stashing est l’un des gestes les plus rassurants de Git. Je te livre ici un guide complet, avec ses pièges et ses pépites, pour l’adopter en toute confiance.

⏱️ Pas le temps de lire ?

  • Le stashing met ton travail en cours de côté sans avoir besoin de le commiter.
  • git stash apply conserve le stash, git stash pop le supprime après application.
  • Par défaut, les fichiers non suivis ne sont pas inclus : pense à git stash -u.
  • Un stash supprimé peut souvent être récupéré via git fsck –unreachable.
  • Pour un travail long, sensible ou partagé, préfère un commit WIP sur une branche dédiée.

Le stashing Git, c’est quoi au juste ?

Le stashing consiste à mettre tes modifications en cours de côté dans une pile temporaire, pour retrouver un working directory propre. Tu peux ensuite changer de branche, tirer les dernières mises à jour ou tester autre chose, puis réappliquer ton travail quand tu es prête.

Comment fonctionne le stashing sous le capot

Quand tu lances git stash, Git crée discrètement deux ou trois commits internes qui capturent l’état de ton index et de ton répertoire de travail. Ces commits ne vivent pas sur une branche : ils sont référencés par refs/stash et empilés via le reflog. Tant que ton stash existe, ton travail est conservé localement, à l’abri.

Ce stockage reste strictement local à ta machine. Ton stash n’est pas poussé vers GitHub, GitLab ou Bitbucket, ce qui en fait un outil personnel et privé.

Les bons moments pour sortir le stashing de ton sac

Trois situations classiques où le stashing te sauve la mise. D’abord, un hotfix urgent qui arrive pendant que tu travailles sur autre chose. Ensuite, un git pull qui refuse d’avancer parce que tu as des changements locaux. Enfin, une expérimentation jetable que tu veux tester sans polluer ton historique.

Les commandes du stashing à avoir dans ta trousse

Voici les commandes essentielles, présentées dans l’ordre où tu vas naturellement t’en servir. Garde-les sous le coude le temps de les intégrer dans ton flow.

Commande À quoi elle sert
git stash push -m « message » Stasher avec un libellé clair pour t’y retrouver plus tard.
git stash list Voir tous les stashes empilés sur ton dépôt.
git stash show -p stash@{0} Inspecter le contenu détaillé d’un stash avant de le réappliquer.
git stash apply Réappliquer le stash en le gardant dans la pile.
git stash pop Réappliquer le stash et le retirer de la pile.
git stash -u Inclure les fichiers non suivis dans le stash.
git stash push -p Stasher seulement certains hunks, en mode interactif.
git stash branch nom Convertir un stash en branche dédiée pour le partager ou le finir.

Apply ou pop, quelle est la vraie différence ?

C’est la question piège qui fait perdre du code à beaucoup de développeuses. La nuance est subtile mais elle peut transformer une mise de côté tranquille en mauvaise surprise. Prends une minute pour bien intégrer ce tableau.

Critère git stash apply git stash pop
Effet sur la pile Conserve le stash Supprime le stash après application
Sécurité Plus prudent : le filet reste tendu Plus risqué si tu débutes
En cas de conflit Le stash est toujours là Le stash est conservé aussi, contrairement à la croyance
Quand l’utiliser Pour réutiliser plusieurs fois Pour clôturer une mise de côté courte

Mon conseil de cœur : par défaut, utilise git stash apply, vérifie que ton code est bien remis en place, puis fais un git stash drop volontaire. Cette routine en deux temps évite quasiment toutes les pertes de travail liées au stashing.

Les pièges du stashing à éviter absolument

Le stashing est puissant, mais il a quelques angles morts qu’il vaut mieux connaître. Les deux qui suivent sont responsables de la majorité des moments de panique en équipe.

Les fichiers non suivis qui semblent disparaître

Par défaut, git stash ne stashe que les fichiers déjà suivis par Git. Tes nouveaux fichiers, ceux qui n’ont jamais été ajoutés à l’index, restent en place dans ton working directory. C’est rassurant en réalité, sauf si tu changes de branche en pensant qu’ils sont dans le stash.

Pour les inclure, ajoute simplement le drapeau -u ou –include-untracked. Et si tu veux aussi capturer les fichiers ignorés par .gitignore, c’est git stash -a.

Les secrets qui dorment dans ton reflog

Un stash, ce n’est pas une cachette sûre pour des données sensibles. Tout fichier .env, clé d’API ou token stashé reste dans .git/ et peut être ressorti du reflog des semaines plus tard. C’est un point souvent oublié dans les revues de sécurité.

Pour les secrets, traite-toi comme tu mérites : un vrai gestionnaire (1Password, Vault), un .env bien listé dans ton .gitignore, et zéro stashing. Tu te remercieras dans six mois.

Stashing ou alternatives modernes : que choisir ?

Le stashing reste génial pour des mises de côté courtes, sur la même branche, avec un travail qui ne risque rien si ta machine plante. Mais il a ses limites quand le contexte change. Deux alternatives valent le détour pour ne pas en abuser.

Le commit WIP sur une branche dédiée, suivi d’un git reset HEAD~1 au retour, offre les mêmes bénéfices que le stash tout en étant poussable sur ton remote. C’est l’option à privilégier dès qu’un travail dure plus d’une journée ou que tu veux le voir en sécurité côté serveur.

Le git worktree de son côté permet de bosser sur deux branches en parallèle, dans deux dossiers physiques différents, sans jamais avoir à stasher. Très pratique pour une revue de PR ou un hotfix qui ne doit pas interrompre ta feature en cours.

Comme dans la vie, savoir poser des limites saines à un outil te rend plus sereine au quotidien. Si tu sens que la pression monte côté code mais aussi côté perso, ce guide pour réagir face à un homme trop étouffant sans culpabiliser peut t’aider à remettre les compteurs à zéro. Et si tu cherches d’autres exemples de femmes qui transforment leurs galères en force, le parcours inspirant de Margot Haddad vaut le détour.

Faire du stashing un réflexe sain dans ton quotidien

Quelques bonnes pratiques pour adopter le stashing sans qu’il ne se transforme en cimetière de code oublié. Donne toujours un message à tes stashes avec git stash push -m, n’en accumule jamais plus de trois ou quatre, et passe les revoir une fois par semaine. Ce petit rituel t’évitera de retrouver un stash de mars en plein mois de juillet.

Côté outils, les IDE modernes te facilitent grandement la vie. VS Code, IntelliJ, GitKraken ou Sourcetree exposent le stashing en interface graphique avec un aperçu visuel des changements. Si la ligne de commande t’intimide encore, commence par là, le temps de prendre confiance.

Questions fréquentes sur le stashing

Git stash apply ou pop, quelle différence ?

Apply réapplique le stash et le conserve dans la pile pour réutilisation, tandis que pop l’applique puis le supprime. Beaucoup pensent qu’un conflit pendant un pop efface quand même le stash, mais c’est faux : Git le garde dans ce cas. Si tu débutes, prends l’habitude d’utiliser apply puis drop volontairement, c’est plus serein.

Comment récupérer un stash supprimé sur Git ?

Tant que le garbage collector de Git n’est pas passé, ton stash supprimé survit comme commit non référencé. Lance git fsck –unreachable | grep commit pour lister ces commits orphelins. Inspecte-les avec git show sha, puis récupère ton travail avec git stash apply sha. Cette fenêtre dure généralement entre 30 et 90 jours.

Le git stash inclut-il les fichiers non suivis ?

Non, par défaut le stash ignore tes fichiers untracked. Pour les inclure, utilise git stash -u ou git stash –include-untracked. Si tu veux aussi capturer les fichiers ignorés via .gitignore, c’est l’option git stash -a. C’est la cause numéro un des « mes nouveaux fichiers ont disparu » qui en réalité n’avaient jamais été stashés.

Comment nommer un git stash pour le retrouver plus tard ?

Utilise systématiquement git stash push -m « ton message ». Sans message, ton stash hérite d’une description automatique basée sur le dernier commit, ce qui devient illisible dès que tu en as plusieurs. Privilégie un libellé court qui décrit le pourquoi, comme « refacto formulaire login en cours ». Ton toi du futur te remerciera.

Git stash ou commit WIP, que choisir ?

Le stash est parfait pour une mise de côté courte, sur la même branche, sur moins d’une journée. Le commit WIP sur une branche dédiée est préférable dès que ton travail s’étale sur plusieurs jours, doit survivre à un crash machine, ou doit être visible par ton équipe. Dans le doute, commite : c’est plus difficile à perdre, et tu peux toujours le réécrire ensuite avec git rebase ou git commit –amend.

Retour en haut