Cómo comprobar si una rama de Git se ha eliminado localmente

Introducción

En este laboratorio, aprenderás cómo comprobar si una rama (branch) de Git se ha eliminado localmente. Comenzaremos verificando la ausencia de una rama específica utilizando el comando git branch para garantizar un estado inicial limpio. Luego, exploraremos el comando git reflog, una herramienta poderosa que registra las actualizaciones de las referencias en tu repositorio local, incluyendo la eliminación de ramas, lo que te permite ver la historia de los cambios. Finalmente, probaremos estos métodos trabajando con una rama recientemente eliminada para confirmar cómo comprobar de manera efectiva su estado de eliminación local.

Skills Graph

Ejecutar git branch para Verificar la Ausencia

En este paso, verificaremos que una rama específica, que eliminaremos más adelante, no existe actualmente en nuestro repositorio de Git. Esta es una buena práctica para asegurarnos de comenzar desde un estado limpio antes de realizar operaciones como la eliminación de ramas.

Primero, navega hasta el directorio de tu proyecto si aún no estás allí. Recuerda, nuestro proyecto está ubicado en ~/project/my-time-machine.

cd ~/project/my-time-machine

Ahora, listemos las ramas existentes en nuestro repositorio utilizando el comando git branch. Por defecto, este comando muestra las ramas locales.

git branch

Deberías ver una salida similar a esta:

* master

Esta salida indica que actualmente, solo existe la rama master, y es la rama activa (indicada por el asterisco *).

Con el propósito de este laboratorio, trabajaremos con una rama llamada feature/new-feature. Confirmemos que esta rama no existe aún ejecutando git branch nuevamente. Dado que acabamos de ejecutarlo y solo vimos master, ya sabemos que no está allí, pero ejecutar el comando nuevamente refuerza el concepto de comprobar el estado de las ramas.

git branch

La salida debería seguir mostrando solo la rama master:

* master

Esto confirma que la rama feature/new-feature no está presente en nuestro repositorio en este momento. Este es el estado que esperamos antes de proceder a crear y luego eliminar esta rama en pasos posteriores. Entender cómo comprobar el estado de tus ramas es fundamental para gestionar la historia de tu proyecto de manera efectiva.

Comprobar el git reflog para la Eliminación

En este paso, exploraremos el comando git reflog, que es una herramienta poderosa para recuperar confirmaciones (commits) o ramas perdidas. El reflog (registro de referencias) registra las actualizaciones de las puntas de las ramas y otras referencias en el repositorio local. Esto significa que registra casi todos los cambios que realizas en tu repositorio, incluyendo confirmaciones, fusiones (merges), rebase y hasta la eliminación de ramas.

Primero, asegúrate de estar en el directorio de tu proyecto:

cd ~/project/my-time-machine

Ahora, creemos una nueva rama que eliminaremos más adelante. Esto nos dará algo para buscar en el reflog.

git branch feature/new-feature

Este comando crea una nueva rama llamada feature/new-feature que apunta a la confirmación actual. Verifiquemos que exista:

git branch

Ahora deberías ver ambas ramas:

* master
  feature/new-feature

Ahora, eliminemos la rama feature/new-feature utilizando la bandera -d, que es una eliminación "segura" (evita la eliminación si la rama tiene cambios no fusionados).

git branch -d feature/new-feature

Deberías ver una salida que confirme la eliminación:

Deleted branch feature/new-feature (was <commit-id>).

Reemplaza <commit-id> con el ID de confirmación real mostrado en tu terminal.

Ahora, comprobemos el reflog para ver si se registró la eliminación.

git reflog

La salida mostrará un historial de acciones. Deberías ver una entrada relacionada con la eliminación de la rama, similar a esta (la salida exacta puede variar):

<commit-id> HEAD@{0}: branch: deleted feature/new-feature
<commit-id> HEAD@{1}: branch: Created from <another-commit-id>
... (other reflog entries)

La entrada del reflog HEAD@{0}: branch: deleted feature/new-feature indica que la rama feature/new-feature fue eliminada. El HEAD@{0} se refiere a la acción más reciente. Esto demuestra que, aunque la rama ya no aparece en git branch, su eliminación se registra en el reflog, lo que la hace potencialmente recuperable.

Comprender git reflog es crucial porque actúa como una red de seguridad. Si accidentalmente eliminas una rama o pierdes confirmaciones debido a un rebase u otra operación, el reflog puede ayudarte a encontrar el ID de confirmación que necesitas para restaurar tu trabajo.

Probar con una Rama Recientemente Eliminada

En este paso, demostraremos cómo recuperar potencialmente una rama recientemente eliminada utilizando la información del git reflog. Aunque no recuperaremos completamente la rama en este laboratorio específico (ya que no tenía confirmaciones únicas), practicaremos el comando utilizado para la recuperación.

Primero, asegúrate de estar en el directorio de tu proyecto:

cd ~/project/my-time-machine

Recuerda del paso anterior que eliminamos la rama feature/new-feature. Confirmemos que sigue eliminada:

git branch

La salida debería seguir mostrando solo la rama master:

* master

Ahora, veamos el reflog nuevamente para encontrar la entrada de la rama eliminada.

git reflog

Encuentra la línea que dice branch: deleted feature/new-feature. Anota el ID de confirmación asociado a esta entrada. Se verá algo como <commit-id> HEAD@{0}: branch: deleted feature/new-feature.

Para recuperar una rama eliminada, normalmente se utilizaría el comando git branch <branch-name> <commit-id>, donde <branch-name> es el nombre que quieres dar a la rama recuperada y <commit-id> es el ID de confirmación del reflog al que apuntaba la rama por última vez.

En nuestro caso, la rama feature/new-feature se creó y se eliminó inmediatamente sin ninguna nueva confirmación en ella. Por lo tanto, su ID de confirmación en el reflog será el mismo que la punta de la rama master. Recuperarla esencialmente solo recrearía la rama apuntando al mismo commit que master.

Simulemos el comando de recuperación utilizando el ID de confirmación que encontraste en el reflog de la rama eliminada. Reemplaza <commit-id> con el ID real de la salida de tu reflog.

git branch recovered-feature <commit-id>

Este comando crea una nueva rama llamada recovered-feature que apunta al ID de confirmación donde estaba feature/new-feature antes de la eliminación.

Ahora, comprobemos nuestras ramas nuevamente:

git branch

Ahora deberías ver la rama recovered-feature en la lista:

* master
  recovered-feature

Esto demuestra cómo se puede utilizar el git reflog para encontrar el ID de confirmación de una rama perdida y luego utilizar git branch para recrearla. Esta es una técnica poderosa para recuperarse de eliminaciones accidentales u otras operaciones que alteran el historial.

Resumen

En este laboratorio, aprendimos cómo verificar la ausencia de una rama local de Git utilizando el comando git branch. Confirmamos que antes de crear y eliminar una rama, es importante comprobar el estado actual de las ramas para garantizar un punto de partida limpio.

También comenzamos a explorar el comando git reflog, comprendiendo su función para realizar un seguimiento de los cambios en las referencias del repositorio local, incluyendo la eliminación de ramas, lo cual es crucial para la posible recuperación de trabajo perdido.