Git branch rename: cómo renombrar una rama local y remota de Git

Puedes renombrar una rama Git local o remota uti­li­za­n­do el comando -m. Mientras que esto no es un problema para la rama local, para la rama remota debes eliminar primero la versión obsoleta y su­s­ti­tui­r­la por la nueva.

Git es un sistema de control de versiones que está di­s­po­ni­ble sin licencia y de forma gratuita desde 2005. La ca­ra­c­te­rí­s­ti­ca especial de la he­rra­mie­n­ta es que numerosos de­sa­rro­lla­do­res pueden trabajar si­mu­l­tá­nea­me­n­te y de forma co­m­ple­ta­me­n­te autónoma en un proyecto. Esto se debe a que Git no funciona con un re­po­si­to­rio central, sino que cada usuario puede descargar una copia en su ordenador local. Esto también actúa como copia de seguridad. Git se ca­ra­c­te­ri­za por su facilidad de uso y por ser de rápido apre­n­di­za­je. En la Digital Guide en­co­n­tra­rás un tutorial Git, que te ayudará a dar los primeros pasos con la he­rra­mie­n­ta y te asegurará que pronto puedas iniciar tus propios proyectos.

Para entender cómo funciona el Git branch rename, es co­n­ve­nie­n­te observar primero cómo está es­tru­c­tu­ra­do y cómo se utiliza realmente Git. El re­po­si­to­rio de Git es crucial en este sentido. El sistema de control de versiones utiliza el re­po­si­to­rio como una especie de depósito de recogida. Todos los archivos de las versiones actuales y an­te­rio­res de un proyecto se almacenan aquí y se ponen a di­s­po­si­ción de todos los de­sa­rro­lla­do­res. De este modo, se puede seguir fá­ci­l­me­n­te cualquier cambio y los errores se pueden corregir más rá­pi­da­me­n­te. A di­fe­re­n­cia de sistemas como SVN, Git no se basa en un re­po­si­to­rio central, sino en numerosas copias locales. Cada de­sa­rro­lla­dor puede trabajar en ellas de forma in­de­pe­n­die­n­te.

Si un gran número de de­sa­rro­lla­do­res trabajan en un proyecto y siguen enfoques di­fe­re­n­tes, es aún más im­po­r­ta­n­te separar los pasos de trabajo y seguir ma­n­te­nie­n­do una visión general. Para ello, Git utiliza las llamadas ramas (o branch). Esta imagen se presta a imaginar la na­tu­ra­le­za de las ramas. Así, numerosas ramas pequeñas o líneas de de­sa­rro­llo se de­s­pre­n­den del gran tronco de todo el proyecto, en el que se puede trabajar de forma autónoma. Con las ramas se pueden añadir nuevas fu­n­cio­na­li­da­des o arreglar errores rá­pi­da­me­n­te. Sin embargo, el código original no se modifica.

Puede haber ocasiones en las que necesites renombrar una Rama Git. Esto se debe a que, si la de­no­mi­na­ción es in­co­rre­c­ta y otros de­sa­rro­lla­do­res siguen tra­ba­ja­n­do con ella, puedes tener problemas. Afo­r­tu­na­da­me­n­te, a pesar de la estrecha in­te­gra­ción y de las diversas bi­fu­r­ca­cio­nes, si quieres renombrar una rama Git, no es muy co­m­pli­ca­do. Para ello, utiliza el comando -m. La sintaxis co­rre­s­po­n­die­n­te sigue siempre la misma es­tru­c­tu­ra:

“git branch -m”

Sin embargo, hay di­fe­re­n­cias entre las ramas que se editan lo­ca­l­me­n­te y las que ya son remotas. A co­n­ti­nua­ción, ex­pli­ca­mos los pasos para ambos casos.

Una rama Git local solo existe en tu ordenador. Aquí realizas cambios y pruebas sin que otros de­sa­rro­lla­do­res se den cuenta. Por lo tanto, cambiar su nombre se hace rá­pi­da­me­n­te.

1. En la línea de comandos, se­le­c­cio­na la rama Git que quieres renombrar. El comando para ello es “git checkout alter-name”.
2. Obtendrás una co­n­fi­r­ma­ción de que has se­le­c­cio­na­do la rama correcta. El texto será el siguiente “Switched to branch ‘nombre-antiguo’”.
3. Ahora procede a renombrar la rama local de Git. El comando adecuado para ello es: “git branch -m nombre-nuevo”.

También tienes la opción de renombrar la rama Git a través del master. Para ello, sigue los si­guie­n­tes pasos:

1. Cambia al master mediante el comando “git checkout master”.
2. Ahora introduce el siguiente comando si quieres renombrar una rama Git: “git branch -m nombre-antiguo nombre-nuevo”.
3. Para ase­gu­rar­te de que el cambio de nombre se ha realizado con éxito, recupera el estado actual de la rama uti­li­za­n­do el comando “git branch -a”.

En un re­po­si­to­rio remoto, no puedes si­m­ple­me­n­te renombrar una rama Git, ya que esto daría lugar a problemas. En su lugar, tienes que eliminar el nombre antiguo y luego añadir la rama con el nuevo nombre. Afo­r­tu­na­da­me­n­te, esto tampoco es demasiado difícil y puede hacerse con unos simples comandos. Al igual que con la rama local, tienes dos opciones.

1. En primer lugar, asegúrate de que la rama local tiene el nuevo nombre correcto. El comando adecuado es “git branch -a”.
2. Ahora elimina la rama con el nombre antiguo e in­co­rre­c­to del re­po­si­to­rio remoto. Para ello, utiliza el siguiente comando: “git push origin --delete alter-name”.
3. Comprueba que la rama antigua se ha eliminado co­rre­c­ta­me­n­te.
4. Ahora añade la rama con el nombre correcto. Para ello, utiliza el comando “git push origin -u nombre-nuevo”.
5. Por último, realiza un reset de la rama superior para ase­gu­rar­te de que los cambios son efectivos.

Sin embargo, si quieres renombrar la Branch Git remota con un solo comando, también tienes la siguiente opción.

1. Introduce el siguiente comando: “git push origin : nombre-antiguo nombre-nuevo”.
2. A co­n­ti­nua­ción, realiza también un reset de la rama superior como se ha descrito an­te­rio­r­me­n­te.

Los errores ocurren y Git está diseñado para pe­r­mi­ti­r­te renombrar las ramas de Git fá­ci­l­me­n­te. Se puede hacer rá­pi­da­me­n­te y con unos pocos comandos. Mientras que el proceso es un re­no­m­bra­mie­n­to en sentido estricto para las ramas locales, es necesario un borrado en la rama remota. Una vez so­lu­cio­na­do el error, merece la pena volver a co­m­pro­bar­lo de­te­ni­da­me­n­te. Después, tú y otros de­sa­rro­lla­do­res podéis seguir tra­ba­ja­n­do en vuestro proyecto sin ninguna li­mi­ta­ción.