Le "detached HEAD state" est-il une erreur ?

Non, ce n'est pas une erreur. C'est un avertissement. Git vous indique que HEAD pointe directement vers un commit au lieu d'une branche. Vous pouvez toujours explorer, faire des modifications et commiter. Le risque est que ces commits peuvent etre perdus si vous changez de branche sans les avoir sauvegardes au prealable.

Pourquoi le checkout d'un commit provoque-t-il un HEAD detache ?

Les branches sont des pointeurs mobiles vers des commits. Lorsque vous faites un checkout sur une branche, HEAD pointe vers la branche, et la branche pointe vers un commit. Lorsque vous faites un checkout sur un hash de commit directement, il n'y a pas de branche impliquee, donc HEAD est "detache" de toute branche.

Vais-je perdre mes commits en HEAD detache ?

Pas immediatement. Mais si vous changez de branche sans creer une nouvelle branche au prealable, ces commits deviennent orphelins. Ils existent toujours dans le depot et peuvent etre retrouves avec "git reflog" pendant environ 30 jours avant que le ramasse-miettes de Git ne les supprime.

Comment eviter le HEAD detache a l'avenir ?

Utilisez "git switch" au lieu de "git checkout" pour la navigation entre branches. git switch vous avertira plus clairement et ne detachera pas HEAD a moins que vous n'utilisiez explicitement le drapeau --detach. Lorsque vous devez inspecter un tag ou un ancien commit, creez immediatement une branche avec "git switch -c nom-branche ".

Le rebase interactif provoque-t-il un HEAD detache ?

Oui. Pendant un rebase interactif, Git entre temporairement en etat de HEAD detache pour rejouer les commits un par un. C'est normal. Une fois le rebase termine, HEAD se rattache a votre branche. Si le rebase est interrompu, lancez "git rebase --abort" pour revenir a votre branche en toute securite.

detached HEAD state — Comprendre cet etat Git

Ce n'est pas vraiment une erreur mais un avertissement qui deroute beaucoup de debutants. HEAD pointe vers un commit au lieu d'une branche. Voici ce que cela signifie et comment le gerer.

Apprendre Git pas a pas

Avertissement

Ce que cet avertissement signifie

Dans Git, HEAD est un pointeur qui indique a Git sur quel commit vous travaillez actuellement. Normalement, HEAD pointe vers une branche (comme main), et la branche pointe vers un commit.

Lorsque vous etes en etat de HEAD detache, HEAD pointe directement vers un commit au lieu d'une branche. Vous pouvez toujours parcourir les fichiers, faire des modifications et creer des commits — mais ces commits n'appartiennent a aucune branche.

Le danger est que si vous changez de branche sans sauvegarder votre travail, ces commits orphelins peuvent finir par etre supprimes par le ramasse-miettes et etre perdus. La solution est simple : creez une branche avant de changer.

terminal — HEAD detache

$git checkout a1b2c3d

Note: switching to 'a1b2c3d'.

You are in 'detached HEAD' state. You can look around, make experimental

changes and commit them, and you can discard any commits you make in this

state without impacting any branches by switching back to a branch.

Pourquoi cela se produit

Checkout d'un commit specifique

Lancer git checkout a1b2c3d deplace HEAD directement vers ce commit. Puisque vous n'etes pas sur une branche, Git entre en etat de HEAD detache. C'est le declencheur le plus courant.

Checkout d'un tag

Les tags pointent vers un commit specifique, pas vers une branche. Lancer git checkout v1.0.0 vous met en HEAD detache tout comme le checkout d'un hash de commit. Pour travailler a partir d'un tag, creez immediatement une branche.

Pendant un rebase interactif

Lorsque vous lancez git rebase -i, Git rejoue vos commits un par un en etat de HEAD detache. C'est normal et temporaire — HEAD se rattache a votre branche une fois le rebase termine.

Comment corriger

Deux options : sauvegarder votre travail sur une nouvelle branche, ou revenir a une branche existante.

1. Sauvegarder sur une nouvelle branche

terminal — sauvegarder

# Sauvegardez votre travail en creant une nouvelle branche

$git switch -c my-new-branch

Switched to a new branch 'my-new-branch'

# Tous vos commits sont maintenant en securite sur cette branche

$git log --oneline -3

f8e9d0a Your latest commit in detached HEAD

a1b2c3d The commit you checked out

7c6d5e4 Previous commit

2. Revenir a une branche

terminal — revenir

# Revenir a une branche existante (abandonner le travail detache)

$git switch main

Switched to branch 'main'

# Si vous avez fait des commits en HEAD detache et oublie de sauvegarder :

$git reflog

f8e9d0a HEAD@{1}: commit: work done in detached HEAD

a1b2c3d HEAD@{2}: checkout: moving from main to a1b2c3d

# Recuperez les commits perdus avec cherry-pick ou branch

$git cherry-pick f8e9d0a

[main g7h8i9j] work done in detached HEAD

3. Travailler depuis un tag

terminal — branche tag

# Checkout un tag vous met en HEAD detache

$git checkout v1.0.0

You are in 'detached HEAD' state.

# Pour travailler a partir de ce tag, creez une branche

$git switch -c hotfix-from-v1

Switched to a new branch 'hotfix-from-v1'

Comment prevenir cette situation

Utiliser git switch au lieu de git checkout

git switch est concu pour la navigation entre branches et refuse de detacher HEAD sauf si vous utilisez explicitement --detach. Cela previent les situations accidentelles de HEAD detache.

Creer une branche lors de l'inspection d'anciens commits

Au lieu de git checkout a1b2c3d, utilisez git switch -c inspecter-commit a1b2c3d. Cela vous donne une branche immediatement, donc tout commit que vous faites est en securite.

Savoir quand le HEAD detache est normal

Pendant git rebase -i ou git bisect, le HEAD detache est attendu. Pas de panique — laissez simplement l'operation se terminer ou annulez-la proprement si quelque chose ne va pas.

Commandes associees

git switch

Maniere moderne de changer de branche sans detacher HEAD

git checkout

Changer de branche, restaurer des fichiers ou detacher HEAD

git branch

Creer, lister et gerer les branches

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

Maitrisez les branches Git avec GitQuest

Pratiquez le branching, le merge et la navigation entre commits grace a des investigations interactives.

Commencer a apprendre Git