Git: Renombrar una rama
Última actualización
Renombras una rama con git branch -m (la -m es de "move", mover). Con un argumento renombra la rama en la que estás; con dos renombra cualquier rama por su nombre. Renombrar es puramente local: si la rama ya se había subido, también eliminas el nombre antiguo en el remoto y subes el nuevo.
Prueba esto en el terminal playground: una shell real en tu navegador, sin nada que instalar.
Sintaxis
| Command | What it does |
|---|---|
git branch -m new-name | Renombra la rama en la que estás actualmente |
git branch -m old-name new-name | Renombra otra rama por su nombre |
git branch -M new-name | Renombra forzando (sobrescribe un nombre existente) |
Renombrar una rama que está en el remoto
Renombrar es local, así que una rama ya subida necesita tres pasos adicionales.
| Step | Command | Result |
|---|---|---|
| 1 | git branch -m old new | Renombra la rama localmente |
| 2 | git push origin --delete old | Elimina el nombre antiguo en el remoto |
| 3 | git push -u origin new | Sube el nuevo nombre y define el upstream |
Preguntas frecuentes sobre renombrar ramas en Git
¿Cómo renombro la rama en la que estoy actualmente?
Ejecuta
git branch -m new-name con solo el nombre nuevo. Git renombra la rama actual en el sitio: sigues en ella, y tus commits e historial quedan intactos.¿Cómo renombro una rama sin cambiarme a ella?
Pasa ambos nombres:
git branch -m old-name new-name. Esto renombra old-name a new-name aunque estés actualmente en otra rama.¿Cómo renombro una rama que ya está en GitHub?
Renómbrala localmente con
git branch -m old new, elimina el nombre antiguo en el remoto con git push origin --delete old, y luego sube el nuevo nombre y define su upstream con git push -u origin new. Cualquier otra persona que tenga la rama antigua tendrá que actualizar su copia local.¿Cuál es la diferencia entre -m y -M?
-m (move) renombra la rama pero se niega si ya existe una rama con el nombre de destino, así que no puedes pisar otra rama por accidente. -M fuerza el renombrado, sobrescribiendo una rama existente con ese nombre. Usa -m a menos que realmente pretendas sobrescribir.¿Puedo practicar esto en línea?
Sí. Abre el terminal playground para ejecutar estos comandos en una shell real en tu navegador, sin nada que instalar. El curso interactivo y gratuito de Git de Coddy también cubre el uso de ramas de principio a fin.
Recursos relacionados
Más comandos de Git
