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.

En este artículo

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.

Al cambiar el nombre de una rama, cualquier URL que contenga el nombre de la rama antigua se redireccionará automáticamente a la URL equivalente para la rama que se ha cambiado de nombre. 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á cerrar y que sugiera que los usuarios se migren al nombre de la rama nueva.

Los conjuntos de reglas de la organización que se aplican a las ramas de un repositorio ya no permiten al administrador del repositorio cambiar el nombre de las ramas del repositorio de destino ni cambiar la rama predeterminada por otra. Los administradores del repositorio pueden crear y eliminar ramas siempre que tengan los permisos adecuados.

Renombrar una rama

  1. En GitHub, navegue hasta 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 cuyo nombre deseas cambiar, selecciona el menú desplegable y, a continuación, haz clic en Rename branch.

  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, 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/NEW-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