~ / hub / erros / Git "detached HEAD": o que é e como sair
4 out 2026errosguia de solução

Git "detached HEAD": o que é e como sair

Você está num commit, não numa branch. Salve o trabalho e volte.

1. O que significa

You are in 'detached HEAD' state. You can look around, make experimental changes and commit them...

Normalmente o HEAD aponta para uma branch, que avança a cada commit. Em detached HEAD, ele aponta direto para um commit específico. Isso acontece ao fazer checkout de uma tag, de um hash ou de origin/main, e durante certas operações de rebase.

2. Só estava olhando? Volte para a branch

git switch main      # ou: git checkout main

Se não fez commits, nada se perde. Alterações não commitadas no diretório de trabalho acompanham você (ou o Git avisa se houver conflito).

3. Fez commits nesse estado? Salve numa branch

git switch -c minha-correcao      # cria branch a partir do ponto atual
# agora seus commits estão numa branch normal

Se já trocou de branch e “perdeu” os commits, eles ainda existem por um tempo. Encontre-os pelo reflog:

git reflog
# localize o hash do último commit feito em detached HEAD
git branch recuperado <hash>

4. Casos comuns

  • Checkout de tag (git checkout v1.2.0): perfeito para inspecionar uma versão; crie branch se for modificar.
  • Submódulos: ficam em detached HEAD no commit registrado pelo projeto principal; isso é esperado.
  • CI/CD: muitos pipelines clonam em detached HEAD; para criar commits ali, faça checkout da branch explicitamente.
  • Durante um rebase: o Git fica desanexado até concluir ou abortar (git rebase --abort).
REGRA Antes de commitar, olhe a saída de git status: se começa com “HEAD detached at …”, crie uma branch primeiro.

Continue explorando

← erros · Push rejeitado · Merge conflict · Roadmap Git · Curso de Git

Veja também o hub de conteúdo, o glossário e os cursos gratuitos.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →