Comment renommer une branche Git locale et distante

Présentation

Git est un progiciel utilisé pour suivre les logiciels au fur et à mesure qu'ils progressent dans les étapes de développement. Git utilise la création de branches pour maintenir un référentiel central de code tout en créant une copie sur laquelle apporter des modifications.

Dans ce guide, découvrez comment modifier le nom d'une branche Git sur un système local ou un référentiel distant.

Prérequis

• Une installation existante sur Git sur CentOS ou Git pour Ubuntu
• Un système d'exploitation basé sur Linux
• Accès à une fenêtre de terminal/ligne de commande (Ctrl+Alt+T ou Ctrl+Alt+F2)

Renommer la branche locale

Pour renommer une branche dans Git :

1. Saisissez le nom de la branche que vous souhaitez modifier dans votre interface de ligne de commande :

git checkout old-branch

Vous devriez recevoir la confirmation que la succursale est extraite.

2. Renommez la branche en saisissant la commande :

git branch -m new-name

Alternativement, vous pouvez utiliser une seule commande. Si vous n'êtes pas déjà dans le maître, passez-y :

git checkout master

Saisissez ce qui suit pour modifier le nom d'une succursale :

git branch -m old-name new-name

3. Vérifiez que le changement de nom a réussi en vérifiant le statut :

git branch -a 

La sortie confirme que la branche a été renommée avec succès, comme indiqué ci-dessous.

Ceci est utile si vous avez créé une nouvelle branche et poussé les modifications de votre référentiel distant pour découvrir que le nom de la branche était incorrect.

Renommer une branche Git distante

Il n'existe aucun moyen de renommer directement une branche Git dans un référentiel distant. Vous devrez supprimer l'ancien nom de branche, puis pousser une branche avec le nom correct vers le référentiel distant.

1. Vérifiez que la succursale locale porte le nom correct :

git branch -a

2. Ensuite, supprimez la branche portant l'ancien nom sur le référentiel distant :

git push origin --delete old-name

La sortie confirme que la branche a été supprimée.

3. Enfin, poussez la branche avec le nom correct et réinitialisez la branche en amont :

git push origin -u new-name

Alternativement, vous pouvez écraser la branche distante avec une seule commande :

git push origin :old-name new-name

La réinitialisation de la branche amont est toujours nécessaire :

git push origin -u new-name