Git: cambiar el nombre de una sucursal local y remota

¿Cometió un error al nombrar su rama de Git? O tal vez "rama-2" ¿No fue lo suficientemente descriptivo? Por suerte, en Git puedes cambiar el nombre de una rama local bastante e...

¿Cometió un error al nombrar su rama de Git? ¿O tal vez "branch-2" no fue lo suficientemente descriptivo? Afortunadamente, en Git puedes cambiar el nombre de una sucursal local con bastante facilidad. Y aunque también es posible con sucursales remotas, el proceso es un poco más complicado con el uso de una solución alternativa, pero aún funciona según lo previsto.

En este breve artículo, le mostraré cómo cambiar el nombre de las ramas de Git para repositorios locales y remotos.

Cambiar el nombre de una rama local de Git

Para cambiar el nombre de una sucursal local, querrá usar el comando branch de esta manera:

1
$ git branch -m <old-branch-name> <new-branch-name>

La opción -m es un alias para --move, que es análogo al comando mv de Unix.

Siguiendo con la convención vimos con la opción eliminar rama, capitalizando la bandera como -M, que es un alias para -- move --force, te permite "forzar" el cambio. Usar la opción de esta manera le permitirá cambiar el nombre de la rama incluso si el nuevo nombre de la rama ya existe en su repositorio.

Si desea cambiar el nombre de la rama que está desprotegida actualmente, puede omitir la opción <nombre-de-sucursal-antiguo>, que se ve así:

1
$ git branch -m <new-branch-name>

Cambiar el nombre de una rama remota de Git

Cambiar el nombre de una sucursal remota es un poco más complicado, y en realidad no es posible de la misma manera que se cambia el nombre de las sucursales locales. Para hacerlo, deberá cambiar el nombre de la sucursal local, eliminar la sucursal remota y luego enviar la sucursal local renombrada al repositorio remoto nuevamente.

En términos de comandos de Git, así es como se ve el proceso:

1
2
3
4
5
$ git branch -m <old-branch-name> <new-branch-name>
$ git push <remote-repo> -d <old-branch-name>
$ git push <remote-repo> <new-branch-name>
$ git checkout <new-branch-name>
$ git push <remote-repo> -u <new-branch-name>

En lenguaje sencillo, esto es lo que sucede línea por línea:

  1. Cambie el nombre de la sucursal local usando el mismo método que se muestra en la primera sección
  2. Elimine la sucursal remota que se va a renombrar
  3. Empuje la nueva rama al repositorio remoto
  4. Cambiar a la nueva sucursal
  5. Restablezca la referencia ascendente para la rama renombrada

Una vez que comprende lo que está sucediendo, no es tan malo, pero ciertamente requiere más pasos que simplemente cambiar el nombre de una sucursal local. .

Licensed under CC BY-NC-SA 4.0