Back to the blog

This article is only available in Spanish.

¿Detached HEAD en Git? No entres en pánico: tus commits siguen ahí

Series: Git without fear

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 switch para cambiar de rama: a diferencia de checkout, 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.