Synopsis

git worktree add <path> [<branch>]
git worktree list
git worktree remove <path>
git worktree prune

Description

The git worktree command lets a single repository have multiple working trees checked out simultaneously, each at a different branch. This is faster and cheaper than cloning multiple times: only one object database, but parallel checkouts. Worktrees are perfect for running tests on a release branch while continuing development on main, or for picking up an emergency fix without disturbing in-progress work.

Each worktree has its own HEAD, index, and working files, but shares the underlying objects and config. Locked worktrees prevent automatic pruning of mounted-elsewhere checkouts.

Dans l'usage quotidien, git worktree s'intègre étroitement avec les alias de shell, les plugins d'éditeur et l'intégration continue. Les utilisateurs avancés ajoutent souvent des alias combinant les flags qu'ils passent toujours, ou enveloppent la commande dans des scripts qui appliquent les conventions d'équipe. Le formatage de la sortie peut être personnalisé via la configuration Git — pretty formats, schémas de couleurs et comportement du pager sont tous ajustables. Quand quelque chose tourne mal, la première étape de diagnostic est généralement de relancer la commande avec GIT_TRACE=1 dans l'environnement, ce qui révèle les appels de plomberie sous-jacents. Pour les situations inhabituelles, la sortie --help (git worktree --help) ouvre la page de manuel complète avec les détails de chaque option, y compris celles rarement utilisées dans les workflows ordinaires mais essentielles pour le débogage ou le scripting à grande échelle.

Comprendre comment git worktree interagit avec le reste du modèle de données de Git — la base d'objets, l'index, les refs et l'arborescence de travail — est rentable. Chaque commande opère sur un sous-ensemble de ces pièces, et savoir laquelle elle touche aide à prédire les résultats et récupérer après les erreurs. Lire la documentation officielle de Git en parallèle de la pratique sur un dépôt jetable est la façon la plus rapide d'intérioriser les subtilités. La plupart des problèmes de production avec Git proviennent de l'une de trois causes : comportement par défaut surprenant, opérations réseau partielles, ou réécriture d'historique déjà partagé. Un modèle mental fonctionnel des effets de bord de git worktree aide à éviter les trois.

Options courantes

Exemples

git worktree add ../project-hotfix release/1.4
# Check out release/1.4 in a sibling directory

git worktree add -b experiment ../project-experiment
# Create a new branch and worktree

git worktree list
# Display all worktrees

git worktree remove ../project-hotfix
# Tear down when finished

Erreurs fréquentes

You cannot have the same branch checked out in two worktrees simultaneously — Git refuses. Use --detach if you only need the contents. Forgetting to worktree remove leaves stale metadata; git worktree prune cleans up.

Commandes liées

git switch, git branch, git clone, git submodule