Mémo Git · Worktrees

Supprimer un worktree

git worktree remove <dossier>

git worktree remove <dossier> supprime le dossier et sa référence dans le dépôt. La branche et ses commits restent : tu peux la rouvrir plus tard, ou la supprimer à part avec git branch -d.

Ce que ça fait

Supprime le dossier et sa référence dans le dépôt. La branche et ses commits restent : tu peux la rouvrir plus tard, ou la supprimer à part.

Un cas d'usage

Ton correctif est mergé : le dossier ne sert plus, et sa branche pourra être supprimée ensuite.

Attention : Tout le contenu du dossier est effacé, y compris les modifications non commitées et les fichiers non suivis ou ignorés. Commite ou recopie d'abord ce que tu veux garder ; un stash est une autre option, car il est partagé entre les worktrees.

En ligne de commande

git worktree remove <dossier>
Supprime un worktree propre. Git refuse s'il reste des modifications.
git worktree remove --force <dossier>
Supprime quand même : les modifications non commitées sont perdues.
git branch -d <branche>
Supprime ensuite la branche, si elle ne sert plus.

Dans Merathon

  1. Ouvre un autre worktree : celui qui est affiché ne peut pas être supprimé, pas plus que le principal.
  2. Clic droit sur le worktree → « Supprimer… ».
  3. La confirmation indique combien de fichiers seraient perdus ; l'onglet du worktree se ferme ensuite.

Questions fréquentes

Mes commits sont-ils perdus ?

Non : ils appartiennent au dépôt et restent sur la branche. Seuls les fichiers non commités du dossier disparaissent.

Puis-je supprimer le worktree principal ?

Non : c'est le dossier d'origine, qui contient le dépôt. Git le refuse.

J'ai supprimé le dossier à la main. Est-ce grave ?

Non, mais le dépôt garde sa référence et sa branche reste considérée comme extraite : git worktree prune règle le problème.

Voir aussi