Git : Renommer une branche
Dernière mise à jour
Vous renommez une branche avec git branch -m (le -m signifie "move", déplacer). Avec un seul argument, il renomme la branche sur laquelle vous êtes ; avec deux, il renomme n'importe quelle branche par son nom. Le renommage est purement local : si la branche avait déjà été poussée, vous supprimez aussi l'ancien nom sur le distant et poussez le nouveau.
Essayez ceci dans le terminal playground : un vrai shell dans votre navigateur, rien à installer.
Syntaxe
| Command | What it does |
|---|---|
git branch -m new-name | Renomme la branche sur laquelle vous êtes actuellement |
git branch -m old-name new-name | Renomme une autre branche par son nom |
git branch -M new-name | Renomme de force (écrase un nom existant) |
Renommer une branche qui est sur le distant
Le renommage est local, donc une branche déjà poussée nécessite trois étapes supplémentaires.
| Step | Command | Result |
|---|---|---|
| 1 | git branch -m old new | Renomme la branche localement |
| 2 | git push origin --delete old | Supprime l'ancien nom sur le distant |
| 3 | git push -u origin new | Pousse le nouveau nom et définit l'upstream |
FAQ sur le renommage de branche Git
Comment renommer la branche sur laquelle je suis actuellement ?
Exécutez
git branch -m new-name avec seulement le nouveau nom. Git renomme la branche courante sur place : vous y restez, et vos commits et votre historique restent intacts.Comment renommer une branche sans y basculer ?
Passez les deux noms :
git branch -m old-name new-name. Cela renomme old-name en new-name même si vous êtes actuellement sur une autre branche.Comment renommer une branche qui est déjà sur GitHub ?
Renommez-la localement avec
git branch -m old new, supprimez l'ancien nom sur le distant avec git push origin --delete old, puis poussez le nouveau nom et définissez son upstream avec git push -u origin new. Toute autre personne qui possède l'ancienne branche devra mettre à jour sa copie locale.Quelle est la différence entre -m et -M ?
-m (move) renomme la branche mais refuse si une branche portant le nom cible existe déjà, ce qui vous empêche d'écraser une autre branche par accident. -M force le renommage en écrasant une branche existante de ce nom. Utilisez -m sauf si vous avez spécifiquement l'intention d'écraser.Puis-je m'exercer en ligne ?
Oui. Ouvrez le terminal playground pour exécuter ces commandes dans un vrai shell dans votre navigateur : rien à installer. Le cours Git interactif et gratuit de Coddy couvre aussi les branches de bout en bout.
Ressources associées
Plus de commandes Git
