Mémo Git · Branches

Renommer une branche

git branch -m <ancien> <nouveau>

git branch -m <ancien> <nouveau> renomme une branche locale ; ses commits ne changent pas. Sur la branche courante, git branch -m <nouveau> suffit. La branche distante, elle, garde son ancien nom tant que tu ne la republies pas.

Ce que ça fait

Change le nom d'une branche locale sans modifier ses commits.

Un cas d'usage

Ta branche s'appelle « test » et tu veux un nom qui décrive le travail avant de la publier.

En ligne de commande

git branch -m <nouveau>
Renomme la branche courante.
git branch -m <ancien> <nouveau>
Renomme une autre branche.
git push -u origin <nouveau>
Publie la branche sous son nouveau nom.
git push origin --delete <ancien>
Supprime l'ancien nom sur le remote.

Dans Merathon

  1. Clic droit sur la branche dans « Local » → « Renommer… ».

Questions fréquentes

Comment renommer master en main ?

git branch -m master main, git push -u origin main, change la branche par défaut dans les réglages de la forge, puis git push origin --delete master.

Renommer une branche casse-t-il une pull request ouverte ?

Sur GitHub, renomme plutôt la branche depuis l'interface du dépôt : les pull requests suivent. Supprimer l'ancienne branche distante ferme les pull requests qui en partent.

Voir aussi