Para cambiar el nombre de la sucursal local actual, use «git branch -m new-name». Para cambiar el nombre de una rama local desde dentro de otra, usa «git branch -m old-name new-name». Para cambiar el nombre de una rama remota, elimínela con «git push origin –delete old-name», luego presione la rama local renombrada con «git push origin -u new-name».
La ramificación es un ejercicio trivial en Git. Desafortunadamente, las tareas triviales rara vez reciben la debida atención y ocurren errores. Si le has puesto un nombre incorrecto a una rama, tendrás que cambiarle el nombre. Así es como se hace.
Por qué los nombres de las sucursales son importantes en Git
Cualquier cosa que tuviera que ver con las ramas en los sistemas clásicos de control de versiones (VCS) era un gran problema. Requería un entendimiento coordinado de que se estaba agregando o fusionando una sucursal, y todas las personas que usaban ese repositorio tenían que asegurarse de no hacer nada, u olvidarse de hacer algo, para que la operación continuara y tuviera éxito.
Las operaciones que involucraban sucursales a menudo también eran muy lentas. Hubo una penalización de tiempo en el tope usando ramas. Git fue diseñado desde el principio para ser diferente. Debido a que es un sistema de control de versiones distribuido, cada usuario tiene una copia del repositorio completo en su máquina local.
La bifurcación en su máquina local no afecta a nadie más a menos que envíe la bifurcación a un repositorio remoto. Y en Git, las operaciones de sucursal están diseñadas para ser tan fáciles de usar como rápidas de completar. La ramificación en Git es muy barata en términos computacionales. Es una acción trivial dentro del repositorio local.
De hecho, se alienta a los desarrolladores a ramificarse, y ramificarse a menudo. Las sucursales son solo otra herramienta dentro de su VCS de la que se beneficia. Las ramas no son grandes cosas aterradoras en Git, son una de sus características más utilizadas.
Pero la familiaridad puede conducir al desprecio. O, al menos, a una consideración casual por las ramas. La ramificación puede ser rápida y simple en Git, pero aún debe concentrarse cuando crea una rama. Es fácil escribir mal el nombre de una rama o escribir el nombre incorrecto, lo que da como resultado una rama con un nombre incorrecto.
Si la rama se enviará al repositorio remoto en algún momento, debe escribirse correctamente. Si no es así, causará confusión cuando otros intenten usarlo.
RELACIONADO: ¿Cómo funcionan las ramas de Git?
Enumerar ramas en Git antes de cambiarles el nombre
Verificar cuáles son los nombres de las sucursales actuales es un buen primer paso. Él git branch el comando enumera las ramas para nosotros. Puedes ver las ramas en el repositorio local con este comando:
git branch
Las sucursales están listadas para nosotros. La rama actual está resaltada en verde y con un asterisco.
Para ver las ramas y sus compromisos, puede usar el show-branch dominio.
git show-branch
Puede ver las ramas en el repositorio remoto al incluir la opción -r (remoto).
git branch -r
Para ver sucursales locales y remotas con un solo comando, use el -a (todas) la opción.
git branch -a
Tenemos más sucursales locales que sucursales remotas. La rama «feature16» aún no se ha enviado al repositorio remoto. Eso es solo un aspecto de la operación normal, no un problema.
Nuestro problema es que la rama «feature19» debería haberse llamado «feature18». Así que ese es el error que vamos a corregir.
RELACIONADO: Cómo actualizar y mantener ramas separadas de Git
Cómo cambiar el nombre de una sucursal local en Git
Hay dos formas de cambiar el nombre de una sucursal localmente. Puede pagar la sucursal y cambiarle el nombre, o puede cambiar el nombre de la sucursal mientras trabaja en otra sucursal.
Para renombrar el Actual rama, asegúrese de que haya verificado y esté usando la rama que desea cambiar de nombre. Luego usa el git branch comando con el -m (mover) opción.
git checkout feature19
git branch -m feature18
Verificamos la rama «feature19» y la renombramos a «feature18». Veamos cómo se ven nuestras sucursales ahora.
git branch
Nuestra sucursal ahora tiene el nombre correcto en el repositorio local.
Si lo desea, puede cambiar el nombre de una sucursal cuando esté trabajando en otra sucursal. Aquí hay un ejemplo en el que estamos trabajando en la rama «maestra».
git branch
El comando que usamos es el mismo comando que antes, pero debemos proporcionar el nombre actual de la rama que estamos renombrando, así como el nuevo nombre que queremos que tenga.
git branch -m feature19 feature18
git branch
Nuevamente, la sucursal en nuestro repositorio local ha sido renombrada con el nombre correcto.
RELACIONADO: Cómo crear una nueva sucursal en GitHub
Cómo cambiar el nombre de una sucursal remota en Git
El repositorio remoto aún contiene la rama con el nombre anterior. Para cambiar el nombre de una rama remota, eliminamos la rama anterior y empujamos la nueva rama.
Si otros usuarios usan esta rama y le envían confirmaciones, debe hacer una extracción antes de cambiarle el nombre localmente. Esto garantiza que su repositorio local esté actualizado y que los cambios realizados por otros usuarios no se perderán. Regresar sus cambios a su repositorio antes de cambiar el nombre de la rama localmente significa que esos cambios estarán en la nueva rama cuando la vuelva a enviar al repositorio remoto.
Echemos un vistazo al estado de nuestras sucursales. Usaremos el -a (todas) opción para ver tanto las sucursales locales como las remotas.
git branch -a
Necesitamos eliminar «feature19» del repositorio remoto y enviar «feature18» al control remoto.
git push origin --delete feature19
Se le pedirá la contraseña para el repositorio remoto. Una vez que se haya realizado la eliminación, verá un mensaje de confirmación.
Ahora enviaremos nuestra nueva rama al control remoto y usaremos la opción -u (establecer upstream)
git push origin -u feature18
Nuevamente, se le pedirá su contraseña para el control remoto. La nueva rama se envía al control remoto y se nos dice que la rama «feature18» está configurada para realizar un seguimiento de los cambios en nuestra copia local de la rama.
Comprobemos una vez más en qué estado se encuentran nuestras sucursales locales y remotas.
git branch -a
Nuestra sucursal ha sido renombrada con éxito tanto local como remotamente, y la sucursal remota está rastreando los cambios en nuestra sucursal local.
RELACIONADO: Cómo eliminar ramas de Git en repositorios locales y remotos
Cambiar el nombre de las sucursales es simple
Con Git, cambiar el nombre de las ramas es simple. Si es la única persona que usa un repositorio o una rama que necesita renombrarse, es muy simple.
Si otros comparten la rama, asegúrese de comunicarles que va a cambiar el nombre de la rama y que deben impulsar cualquier trabajo no comprometido. Cuando hayan presionado, puede extraer la rama y luego cambiar el nombre de su rama de forma local y remota.
RELACIONADO: Cómo usar git con múltiples repositorios remotos