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.