Comment renommer une branche Git, localement et à distance

Pour renommer la branche sur laquelle vous vous trouvez, exécutez `git branch -m new-name`. Pour renommer une autre branche, exécutez git branch -m old-name new-name. Si la branche est sur un dépôt distant, poussez le nouveau nom avec git push -u origin new-name, puis supprimez l'ancien avec git push origin --delete old-name.

Comment renommer une branche Git locale ?

# the branch you are on
git branch -m feature/search-box

# any other branch
git branch -m feature/search feature/search-box

Les commits ne changent pas et Git déplace le reflog de la branche avec. -m refuse de remplacer une branche qui porte déjà le nouveau nom. -M force cela, alors utilisez-le uniquement lorsque vous avez l'intention de jeter l'autre branche.

Comment renommer une branche distante ?

Git n'a pas de renommage à distance. Vous publiez le nouveau nom et supprimez l'ancien, dans cet ordre :

1. Renommez la branche locale : git branch -m old-name new-name
2. Poussez-le et définissez l'amont : git push -u origin new-name
3. Supprimez l'ancien nom : git push origin --delete old-name

Ignorez -u et la branche continue de suivre l'ancien nom distant. Vous pourrez résoudre ce problème plus tard avec git branch -u origin/new-name. La leçon sur les dépôts distants et les amonts explique ce que fait le suivi.

Que doivent faire mes coéquipiers ?

Leurs clones utilisent toujours l'ancien nom. Chaque personne exécute ceci une fois :

git fetch origin --prune
git branch -m old-name new-name
git branch -u origin/new-name new-name

Comment renommer la branche par défaut ?

Utilisez les paramètres de votre hôte, pas les commandes ci-dessus, car la branche par défaut est également un paramètre sur le serveur et les demandes d'extraction ouvertes pointent vers elle. Après le changement de nom, tout le monde met à jour son clone comme indiqué et actualise également la valeur par défaut du dépôt distant :

git remote set-head origin -a

Pourquoi un changement de nom basé uniquement sur la casse échoue-t-il ?

De nombreux systèmes de fichiers traitent Feature et feature comme le même nom, et Git stocke généralement les branches sous forme de fichiers. Passez par un nom temporaire :

git branch -m Feature feature-tmp
git branch -m feature-tmp feature

Le guide pour renommer et supprimer des branches contient les détails, et comment supprimer une branche couvre le nettoyage de l'ancien nom.