Cómo Solucionar el Error de Git Detached HEAD Paso a Paso

¿Qué es el estado Detached HEAD en Git y por qué ocurre?

El estado Detached HEAD (cabeza desacoplada) en Git ocurre cuando tu repositorio apunta directamente a un commit específico en lugar de hacerlo a una rama activa (como main o master). Esto suele suceder al ejecutar comandos como git checkout o al cambiar a una etiqueta (tag). Aunque no es un error destructivo por sí mismo, si realizas commits en este estado y luego cambias de rama, tus cambios pueden quedar huérfanos y ser eliminados por el recolector de basura de Git.

Causas principales del error Detached HEAD

• Navegar en el historial utilizando el hash de un commit con git checkout.
• Cambiar a un tag específico para pruebas rápidas de versiones anteriores.
• Errores en scripts de integración continua (CI/CD) que clonan repositorios en commits específicos.

Método 1: Volver a la rama anterior sin guardar cambios (Descartar modificaciones temporales)

Si estabas revisando un commit antiguo y no has realizado ningún cambio importante que necesites conservar, simplemente puedes regresar a tu rama de trabajo anterior.

1. Abre tu terminal en la raíz del proyecto.
2. Ejecuta el comando para volver a tu rama principal o de trabajo: git checkout main (reemplaza 'main' por el nombre de tu rama, por ejemplo, master o dev).
3. Verifica que todo esté en orden ejecutando git status.

Método 2: Guardar los cambios realizados en una nueva rama temporal

Si estuviste trabajando y realizando commits mientras estabas en el estado Detached HEAD y no quieres perder ese código, debes crear una nueva rama que apunte a esos cambios.

1. Crea y cambia inmediatamente a una nueva rama usando el siguiente comando: git checkout -b nueva-rama-recuperada.
2. Sube tu nueva rama al repositorio remoto para respaldarla: git push origin nueva-rama-recuperada.
3. Ahora tus cambios están seguros y puedes fusionarlos con tu rama principal mediante un Pull Request o un git merge convencional.