Saltar al contenido
GitTree
guías de git3 minutos de lectura

Cómo cambiar el nombre de una rama de Git, localmente y remotamente

Cambiar el nombre de una rama local requiere un comando. Los remotos no tienen cambio de nombre, por lo que presiona el nuevo nombre y elimina el anterior. Aquí está la secuencia completa, incluido lo que deben hacer tus compañeros de equipo.

Escrito por Kodmora

La casa de software detrás de GitTree

Actualizado
  • Ramas
  • Mandos a distancia y push
En esta página

Para cambiar el nombre de la rama en la que te encuentras, ejecuta `git branch -m new-name`. Para cambiar el nombre de otra rama, ejecuta git branch -m old-name new-name. Si la rama está en un remoto, presione el nuevo nombre con git push -u origin new-name, luego elimine el anterior con git push origin --delete old-name.

¿Cómo cambio el nombre de una rama local de Git?

# the branch you are on
git branch -m feature/search-box

# any other branch
git branch -m feature/search feature/search-box

Las confirmaciones no cambian y Git mueve el registro de la rama con ellas. -m se niega a reemplazar una rama que ya tiene el nuevo nombre. -M fuerza eso, así que úsalo solo cuando quieras tirar la otra rama.

¿Cómo cambio el nombre de una rama remota?

Git no tiene cambio de nombre remoto. Publicas el nuevo nombre y eliminas el antiguo, en este orden:

  1. Cambiar el nombre de la rama local: git branch -m old-name new-name
  2. Empújalo y configura el upstream: git push -u origin new-name
  3. Eliminar el nombre anterior: git push origin --delete old-name

Omita -u y la rama seguirá rastreando el antiguo nombre remoto. Puedes solucionarlo más tarde con git branch -u origin/new-name. La lección sobre remotos y ascendentes explica qué hace el seguimiento.

¿Qué deben hacer mis compañeros de equipo?

Sus clones todavía usan el antiguo nombre. Cada persona ejecuta esto una vez:

git fetch origin --prune
git branch -m old-name new-name
git branch -u origin/new-name new-name

¿Cómo cambio el nombre de la rama predeterminada?

Utilice la configuración de su host, no los comandos anteriores, porque la rama predeterminada también es una configuración en el servidor y las solicitudes de extracción abiertas apuntan a ella. Después del cambio de nombre, todos actualizan su clon como se muestra y también actualizan el valor predeterminado del remoto:

git remote set-head origin -a

¿Por qué falla un cambio de nombre de solo mayúsculas y minúsculas?

Muchos sistemas de archivos tratan a Feature y feature como el mismo nombre y Git suele almacenar ramas como archivos. Pasa por un nombre temporal:

git branch -m Feature feature-tmp
git branch -m feature-tmp feature

Cómo cambiar el nombre de una rama en GitTree

  1. Abrir el menú de la rama.

    Haga clic derecho en la etiqueta de la rama en el gráfico. El menú nombra la rama en cada acción, como Cambiar nombre de función/búsqueda….

  2. cambiarle el nombre

    Escriba el nuevo nombre y presione Cambiar nombre. Su entorno ascendente se mueve con él.

  3. actualizar el remoto

    La rama en el remoto mantiene su nombre anterior hasta que presione la que cambió de nombre. Luego elimine el nombre anterior del menú de la rama.

La guía para cambiar el nombre y eliminar ramas tiene los detalles, y cómo eliminar una rama cubre la limpieza del nombre anterior.

Cambiar nombre se encuentra en el menú de la rama en GitTree, junto a Pagar y Eliminar.
Cambiar nombre se encuentra en el menú de la rama en GitTree, junto a Pagar y Eliminar.

Preguntas frecuentes

¿Cambiar el nombre de una rama cambia sus confirmaciones?

No. Una rama es un nombre que apunta a una confirmación, por lo que solo cambia el nombre. No hay cambios de hash y nadie tiene que cambiar la base.

¿Puedo cambiar el nombre de una rama mientras estoy en ella?

Sí. git branch -m new-name cambia el nombre de la rama actual y tú permaneces en ella.

¿Existe un comando git rename de rama remota?

No. Introduzca el nuevo nombre y luego elimine el anterior. Algunos hosts ofrecen un cambio de nombre en su interfaz web, lo que también mantiene adjuntas las solicitudes de extracción.

¿Qué hace git branch -M?

Cambia el nombre de la rama incluso si el nuevo nombre ya existe, reemplazando esa rama. Utilice -m a menos que lo desee.

¿Por qué mi rama todavía muestra el nombre anterior?

Su corriente arriba todavía apunta allí. Ejecute git branch -u origin/new-name o presione una vez con git push -u origin new-name.

Fuentes

Las afirmaciones sobre otros productos se compararon con sus páginas oficiales el 7 de noviembre de 2026. Los precios y las características cambian; Las páginas de los proveedores son la fuente de la verdad.