Worktrees — Patterns avancés

Le combo ultime : bare repo + worktrees

Au lieu de cloner normalement, clonez en bare et utilisez uniquement des worktrees comme répertoires de travail. C'est le setup préféré des développeurs qui travaillent sur plusieurs branches en permanence.

# Cloner le repo en bare (pas de working tree)
git clone --bare https://github.com/yatho/git-workshop-starter.git ng-baguette-conf.git
cd ng-baguette-conf.git

# Créer des worktrees pour les branches dont vous avez besoin
git worktree add ../ng-baguette-main main
git worktree add ../ng-baguette-staging staging
git worktree add ../ng-baguette-feature feature/dark-mode

ng-baguette-conf.git/   ← tous les objets (partagés, légers)
ng-baguette-main/       ← working tree sur main
ng-baguette-staging/    ← working tree sur staging
ng-baguette-feature/    ← working tree sur feature/dark-mode

Avantages vs clone classique :

• Un seul .git/objects partagé — économie de disque
• git fetch une seule fois, disponible partout
• Impossible d'être "sur la mauvaise branche" par accident

Règles et contraintes à connaître

Contrainte principale

Une branche ne peut être checkoutée que dans un seul worktree à la fois. Tenter de checkout la même branche dans deux worktrees différents échoue avec une erreur claire.

git worktree add ../autre-dossier feature/dark-mode
# fatal: 'feature/dark-mode' is already used by worktree at '../ng-baguette-conf'

C'est une protection intentionnelle — deux index sur la même branche créerait des conflits impossibles à résoudre.

Contrainte	Comportement
Même branche dans deux worktrees	Interdit (erreur claire)
Submodules	Non initialisés automatiquement dans les nouveaux worktrees
Hooks	Partagés (définis dans .git/hooks, s'appliquent à tous)
Sparse checkout	Indépendant par worktree
git stash	Partagé entre tous les worktrees

Tests en parallèle sur plusieurs branches

# Lancer les tests sur deux branches simultanément
git worktree add /tmp/test-branch-a feature/auth
git worktree add /tmp/test-branch-b feature/payments

(cd /tmp/test-branch-a && npm test > /tmp/test-a.log 2>&1) &
(cd /tmp/test-branch-b && npm test > /tmp/test-b.log 2>&1) &
wait

echo "=== Résultats branch-a ===" && tail -5 /tmp/test-a.log
echo "=== Résultats branch-b ===" && tail -5 /tmp/test-b.log

Vos deux suites de tests tournent en parallèle pendant que vous continuez à travailler dans votre worktree principal.

Inspecter les internals

# Le dossier .git/worktrees stocke la référence de chaque worktree lié
ls .git/worktrees/

# Pour chaque worktree lié :
cat .git/worktrees/ng-baguette-hotfix/gitdir
# ~/git-workshop/ng-baguette-hotfix/.git
# (fichier dans le working tree qui pointe vers ici)

cat .git/worktrees/ng-baguette-hotfix/HEAD
# ref: refs/heads/fix/login-prod

cat .git/worktrees/ng-baguette-hotfix/locked 2>/dev/null
# Présent si le worktree est verrouillé (ex: sur un disque réseau)