¿Cómo borrar una rama o branch de Git en local y remoto?

En la mayoría de los casos, es sencillo eliminar una rama de Git. En este artículo te enseño a eliminar una rama o branch de forma local y remota.

Versión rápida

// Eliminar rama localmente
git branch -d <nombre_de_rama>

// Eliminar rama remota
git push origin -d <nombre_de_rama_remota>

Cuándo eliminar ramas

Es común que en un repositorio de Git tengamos diferentes ramas. Son una manera recomendada y de buenas prácticas abrir una rama nueva para crear diferentes funciones y correcciones mientras se aísla el nuevo código del código principal.

Los repositorios a menudo tienen una rama principal master donde está todo el código base principal y los desarrolladores creamos otras ramas para trabajar nuevas funciones o realizar correcciones.

Una vez completamos el trabajo, se recomienda eliminar la rama.

Eliminar una rama localmente

Git no te permitirá eliminar la rama en la que te encuentras actualmente, por lo que debes asegurarte de verificar que te encuentres en la rama principal o en cualquier otra rama que no sea la que deseas eliminar. Para moverte entre ramas o regresar a la principal puedes ejecutar el siguiente comando:

git checkout master

Y para eliminar la rama ejecutas:

git branch -d <nombre_de_rama>

Por ejemplo:

git branch -d fix/login

En este punto la rama local ha sido eliminada.

La opción -d eliminará la rama sólo si ya se ha enviado y fusionado a la rama remota o si la rama sólo se encuentra en tu repositorio local. En caso contrario debes utilizar -D en su lugar si deseas forzar la eliminación de la rama, incluso si aún no se ha sincronizado remotamente.

Eliminar una rama remotamente

El comando para eliminar una rama de forma remota en Git es:

git push origin -d <nombre_de_rama>

Debes tener en cuenta que aquí utilizo origin porque es el nombre que por lo general tienen los repositorios remotos, pero debes fijarte si el tuyo tiene este nombre u otro.

Por ejemplo:

git push origin -d fix/login

En este punto la rama remota ha sido eliminada.

También puedes usar un comando más corto para eliminar una rama remota en Git.

git push origin :<nombre_de_rama>

Por ejemplo:

git push origin :fix/login

Si obtienes un error, esto puede significar que alguien más ha eliminado la rama y no existe.

Intenta sincronizando tu lista de ramas con el siguiente comando:

git fetch -p

El parámetro -p buscará y eliminará las ramas que ya no existan en el repositorio remoto en tu repositorio local.