Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Renombrar una rama

Puedes cambiar el nombre de una rama en un repositorio.

Quién puede usar 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. Después de que se completa el renombramiento, 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. 1. Encima de la lista de archivos, haz clic en Ramas.

    Captura de pantalla de la página del repositorio. Un vínculo con la etiqueta "55 ramas" está resaltado con un contorno naranja.

  2. 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.

  3. Teclea un nombre nuevo para la rama.

  4. 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