Aller au contenu principal
Télécharger

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.

Avertissement

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.

A

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.