This article is only available in Spanish.
¿Detached HEAD en Git? No entres en pánico: tus commits siguen ahí
Haces git checkout de un commit antiguo, o de un tag, y Git te suelta un aviso largo con las palabras detached HEAD. Parece un error grave, pero no lo es: tus commits no han desaparecido y salir es cuestión de un comando.
Qué significa detached HEAD
HEAD es «dónde estás ahora». Normalmente apunta a una rama (main, feature/login), y cada commit nuevo hace avanzar esa rama.
En detached HEAD, HEAD apunta directamente a un commit, sin rama. Pasa cuando haces:
git checkout a1b2c3d # un hash
git checkout v2.0.0 # un tag
git switch --detach main # a propósito
También durante un rebase o un bisect, donde es lo esperado.
Puedes mirar el código, compilar y hasta hacer commits. El problema viene después: esos commits no pertenecen a ninguna rama, y si te vas a otra rama nada los referencia.
Si solo estabas mirando
Vuelve a tu rama y listo:
git switch main # o git switch - para volver a la anterior
Si hiciste commits en detached HEAD
Mientras sigues ahí, crea una rama en ese punto. Es lo que convierte esos commits en trabajo «con nombre»:
git switch -c rescate-login
A partir de aquí es una rama normal: puedes hacer merge, rebase o abrir una pull request.
Si ya te fuiste y crees que lo perdiste
Tampoco está perdido. git reflog guarda por dónde ha pasado HEAD, incluidos esos commits sin rama:
git reflog
# 9f8e7d6 HEAD@{0}: checkout: moving from 4c5d6e7 to main
# 4c5d6e7 HEAD@{1}: commit: Arregla validación del email
Copia el hash del último commit que hiciste en detached HEAD y créale una rama:
git branch rescate-login 4c5d6e7
Hazlo pronto: los commits que ninguna rama referencia acaban borrándose cuando Git hace limpieza (git gc; por defecto tras unos 30 días en el reflog).
Cómo evitar el susto
- Si vas a trabajar sobre un commit antiguo, crea la rama desde el principio:
git switch -c arreglo-v2 v2.0.0. - Usa
git switchpara cambiar de rama: a diferencia decheckout, no entra en detached HEAD salvo que se lo pidas con--detach.
Si lo que necesitas es solo un archivo de otro commit o rama, no hace falta moverse: mira cómo traer un archivo con git restore --source.