Skip to main content

Renombrar una rama

Puedes cambiar el nombre de una rama en un repositorio.

¿Quién puede utilizar esta característica?

People with write permissions to a repository can rename a branch in the repository unless it is the default branch or a protected branch. People with admin permissions can rename the default branch and protected branches.

Acerca de renombrar las ramas

Puedes renombrar una rama en un repositorio de GitHub.com. Para más información sobre las ramas, consulta "Acerca de las ramas".

Cuando renombras una rama en GitHub.com, cualquier URL que contenga el nombre de la rama antigua se redireccionará automáticamente a la URL equivalente para la rama que se renombró. También se actualizan las políticas de protección de rama, así como la rama base para las solicitudes de cambios abriertas (incluyendo aquellas para las bifurcaciones) y para los borradores de lanzamientos. Si la rama cuyo nombre ha cambiado es la rama principal de una solicitud de incorporación de cambios abierta, esta solicitud de incorporación de cambios se cierra.

Si se cambia el nombre de la rama predeterminada del repositorio, GitHub proporciona instrucciones en la página principal del repositorio y dirige a los colaboradores a actualizar sus ambientes locales de Git.

Aunque las URL de archivo se redirigen automáticamente, las URL de archivo sin procesar no se redirigirán. Además, GitHub no realiza ninguna redirección si los usuarios realizan ejecutan git pull para el nombre de rama anterior.

Los flujos de trabajo de GitHub Actions no siguen los cambios de nombre, de forma que si el repositorio publica una acción, cualquiera que la use con @{old-branch-name} sufrirá una interrupción. Debes considerar agregar una rama nueva con el contenido original más una confirmación adicional que reporte que el nombre de rama está obsoletizado y que sugiera que los usuarios se migren al nombre de la rama nueva.

Renombrar una rama

  1. En GitHub.com, navega a la página principal del repositorio.

  2. En la vista de árbol de archivos de la izquierda, selecciona el menú desplegable de ramas de y, a continuación, haz clic en Ver todas las ramas. También puedes encontrar el menú desplegable de ramas en la parte superior del editor de archivos integrado.

    Captura de pantalla de la vista de árbol de archivos de un repositorio. Un menú desplegable para cambiar de rama se expande y se destaca en naranja oscuro.

  3. Junto a la rama a la que desea cambiar el nombre, haga clic en .

    Captura de pantalla de una rama en la lista de ramas. Un icono de lápiz está resaltado con un contorno naranja.

  4. Teclea un nombre nuevo para la rama.

  5. Revise la información sobre los entornos locales y luego haga clic en Renombrar rama.

Actualizar un clon local después de que cambie el nombre de una rama

Después de que renombras una rama en un repositorio con GitHub Enterprise Cloud, cualquier colaborador con un clon local del repositorio necesitará actualizar dicho clon.

Desde el clon local del repositorio en una computadora, ejecuta los siguientes comandos para actualizar el nombre de la rama predeterminada.

git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
git fetch origin
git branch -u origin/OLD-BRANCH-NAME NEW-BRANCH-NAME
git remote set-head origin -a

Opcionalmente, ejecuta el siguiente comando para eliminar las referencias de rastreo al nombre de la rama antigua.

git remote prune origin