detached HEAD state — Comprendre cet état Git
Ce n'est pas vraiment une erreur mais un avertissement qui déroute beaucoup de débutants. HEAD pointe vers un commit au lieu d'une branche. Voici ce que cela signifie et comment le gérer.
Ce que cet avertissement signifie
Dans Git, HEAD est un pointeur qui indique à Git sur quel commit tu travailles actuellement. Normalement, HEAD pointe vers une branche (comme main), et la branche pointe vers un commit.
Lorsque tu es en état de HEAD détaché, HEAD pointe directement vers un commit au lieu d'une branche. Tu peux toujours parcourir les fichiers, faire des modifications et créer des commits — mais ces commits n'appartiennent à aucune branche.
Le danger est que si tu changes de branche sans sauvegarder ton travail, ces commits orphelins peuvent finir par être supprimés par le ramasse-miettes et être perdus. La solution est simple : crée une branche avant de changer.
Pourquoi cela se produit
Checkout d'un commit spécifique
Lancer git checkout a1b2c3d déplace HEAD directement vers ce commit. Puisque tu n'es pas sur une branche, Git entre en état de HEAD détaché. C'est le déclencheur le plus courant.
Checkout d'un tag
Les tags pointent vers un commit spécifique, pas vers une branche. Lancer git checkout v1.0.0 te met en HEAD détaché tout comme le checkout d'un hash de commit. Pour travailler à partir d'un tag, crée immédiatement une branche.
Pendant un rebase interactif
Lorsque tu lances git rebase -i, Git rejoue tes commits un par un en état de HEAD détaché. C'est normal et temporaire — HEAD se rattache à ta branche une fois le rebase terminé.
Comment corriger
Deux options : sauvegarder ton travail sur une nouvelle branche, ou revenir à une branche existante.
1. Sauvegarder sur une nouvelle branche
2. Revenir à une branche
3. Travailler depuis un tag
Comment prévenir cette situation
Utiliser git switch au lieu de git checkout
git switch est conçu pour la navigation entre branches et refuse de détacher HEAD sauf si tu utilises explicitement --detach. Cela prévient les situations accidentelles de HEAD détaché.
Créer une branche lors de l'inspection d'anciens commits
Au lieu de git checkout a1b2c3d, utilise git switch -c inspecter-commit a1b2c3d. Cela te donne une branche immédiatement, donc tout commit que tu fais est en sécurité.
Savoir quand le HEAD détaché est normal
Pendant git rebase -i ou git bisect, le HEAD détaché est attendu. Pas de panique — laisse simplement l'opération se terminer ou annule-la proprement si quelque chose ne va pas.
GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.
Questions sur le detached HEAD state
Maîtrise les branches Git avec GitQuest
Pratique le branching, le merge et la navigation entre commits grâce à des investigations interactives.