HOWTO · Git

Cambiar el nombre de la rama local y remota de Git

Este artículo muestra las formas de cambiar el nombre de la rama local y remota

Mientras trabaja en un proyecto, si alguna vez siente que el nombre de la rama no es adecuado para la rama en la que está trabajando y desea cambiar el nombre de la rama, hay algunas formas de cambiar el nombre de la rama según los diferentes escenarios en los que se encuentre . En este artículo, analizamos cómo cambiar el nombre de la rama en una máquina local o si la rama está en el repositorio remoto.

Cambiar el nombre de la rama local de Git actualmente activa

La sintaxis para cambiar el nombre de la rama actualmente activa se encuentra a continuación.

git branch -m <New_Branch_Name>

Por ejemplo, si estamos trabajando actualmente en el nombre de la rama bug-fix y necesitamos cambiar el nombre a bug-fix-1, podemos usar la siguiente sintaxis para cambiar el nombre de la rama.

git branch -m bug-fix-1

Nota: La bandera -m es la forma abreviada de --move, que actúa de manera similar al comando mv.

Sin embargo, con este método, si enviamos cambios al repositorio remoto, se creará una nueva rama con los cambios y la anterior permanecerá como está.

Cambiar el nombre de una rama de Git no activa

Si estamos trabajando en una rama master y necesitamos cambiar el nombre de otra rama llamada bug-fix a bug-fix-1, podemos seguir la siguiente sintaxis.

git branch -m <Old_Branch_Name> <New_Branch_Name>

Por ejemplo,

git branch -m bug-fix bug-fix-1

Nota: Con git, también podemos establecer un alias para hacer uso de los comandos de git fácilmente como se muestra a continuación.

git config --global alias.rename 'branch -m'

Ahora, con el alias establecido, podemos usar la siguiente sintaxis para cambiar el nombre de la rama git.

git rename <New_Name> # If Renaming Currently Active Branch

O,

git rename <Old_Name> <New_Name> # If Renaming a Not Active Branch

Cambiar el nombre de una rama remota de Git

Si queremos cambiar el nombre de una rama remota, entonces debemos seguir tres pasos.

  • Cambiar el nombre de la rama localmente.
    git branch -m <New_Branch_Name>
    # OR
    git branch -m <Old_Branch_Name> <New_Branch_Name>
    
  • Envía los cambios en el nombre de la rama al repositorio remoto.
    git push origin :<Old_Branch_Name> <New_Branch_Name>
    

    Nota: No se deben perder los dos puntos (:), delante de <Old_Branch_Name>.

  • Establece la rama local para rastrear el repositorio remoto con el mismo nombre, para eso, necesitamos usar la siguiente sintaxis.
    git push --set-upstream origin <New_Branch_Name>