Utiliser le stash en toute sécurité : messages, fichiers non suivis et branches de stash

Objectif

Mettre de côté du travail non commité pour une courte durée, par exemple pour faire un pull ou regarder une autre branche, sans le perdre et sans transformer la liste des stashs en cimetière d'entrées « WIP » sans étiquette.

Prérequis

Savoir ce qu'est un stash : la documentation le décrit comme un objet commit ordinaire ; le plus récent est stocké dans refs/stash et les plus anciens se trouvent dans le reflog de cette référence, désignés comme stash@{0}, stash@{1}, etc. Les fichiers non suivis et ignorés ne sont pas inclus, sauf demande explicite.

Étapes

1. Envisager de ne pas stasher. Si l'interruption doit durer plus d'une heure, commiter sur une branche temporaire (git switch -c wip/topic && git commit -am wip) ou utiliser un second worktree ; les deux constituent un historique ordinaire qui ne peut pas être perdu par accident.
2. Stasher avec un message : git stash push -m "half-done: rate limiter tests". L'étiquette par défaut « WIP on <branch> » ne dit plus rien un jour plus tard.
3. Décider du sort des fichiers non suivis. -u / --include-untracked ajoute les nouveaux fichiers ; -a / --all inclut aussi les fichiers ignorés, ce qui peut embarquer des répertoires de build et des caches. Ne stasher que les chemins visés : git stash push -m "..." -- src/limiter.py.
4. Utiliser --keep-index lorsque la partie indexée est terminée et que seul le reste doit disparaître, et --patch pour choisir les hunks de manière interactive.
5. Pour récupérer le travail, faire d'abord git stash apply, lancer les tests, et seulement ensuite git stash drop. pop fait les deux à la fois ; la documentation note que si l'application échoue avec des conflits, l'entrée n'est pas supprimée, si bien que la forme en deux étapes rend l'état explicite dans tous les cas.
6. Si la branche a tellement évolué que l'application entre en conflit, utiliser git stash branch <name> [<stash>] : cela crée une branche au commit à partir duquel le stash a été pris, y applique le stash sans conflit, et supprime l'entrée.
7. Passer en revue git stash list en fin de semaine et supprimer ce qui est obsolète ; git stash show -p stash@{2} montre le contenu d'une entrée.

Résultat attendu

Chaque entrée de git stash list porte un message qui l'explique, aucun stash ne transporte silencieusement des fichiers générés, et une application échouée ne coûte jamais le stash.

Limites et base de vérification

Les stashs sont locaux et ne sont pas poussés. git stash clear supprime toutes les entrées, et la documentation avertit qu'elles peuvent alors devenir impossibles à récupérer ; des commits orphelins peuvent parfois être retrouvés avec git fsck, mais il s'agit d'un sauvetage, pas d'un flux de travail. Les étapes constituent un protocole proposé, dérivé de la documentation citée.