Git: Renomear um branch
Última atualização
Você renomeia um branch com git branch -m (o -m é de "move", mover). Com um argumento, ele renomeia o branch em que você está; com dois, renomeia qualquer branch pelo nome. Renomear é puramente local: se o branch já tinha sido enviado, você também apaga o nome antigo no remoto e envia o novo.
Experimente isto no terminal playground: um shell real no seu navegador, nada para instalar.
Sintaxe
| Command | What it does |
|---|---|
git branch -m new-name | Renomeia o branch em que você está atualmente |
git branch -m old-name new-name | Renomeia outro branch pelo nome |
git branch -M new-name | Renomeia à força (sobrescreve um nome existente) |
Renomear um branch que está no remoto
Renomear é local, então um branch já enviado precisa de três passos extras.
| Step | Command | Result |
|---|---|---|
| 1 | git branch -m old new | Renomeia o branch localmente |
| 2 | git push origin --delete old | Apaga o nome antigo no remoto |
| 3 | git push -u origin new | Envia o novo nome e define o upstream |
Perguntas frequentes sobre renomear branch no Git
Como renomeio o branch em que estou atualmente?
Execute
git branch -m new-name apenas com o nome novo. O Git renomeia o branch atual no lugar: você permanece nele, e seus commits e histórico ficam intactos.Como renomeio um branch sem trocar para ele?
Passe os dois nomes:
git branch -m old-name new-name. Isso renomeia old-name para new-name mesmo que você esteja atualmente em outro branch.Como renomeio um branch que já está no GitHub?
Renomeie-o localmente com
git branch -m old new, apague o nome antigo no remoto com git push origin --delete old e então envie o novo nome e defina o upstream com git push -u origin new. Qualquer outra pessoa que tenha o branch antigo precisará atualizar sua cópia local.Qual é a diferença entre -m e -M?
-m (move) renomeia o branch, mas recusa se já existir um branch com o nome de destino, então você não sobrescreve outro branch por acidente. -M força a renomeação, sobrescrevendo um branch existente com esse nome. Use -m a menos que você realmente pretenda sobrescrever.Posso praticar isto online?
Sim. Abra o terminal playground para executar esses comandos em um shell real no seu navegador, nada para instalar. O curso interativo e gratuito de Git da Coddy também cobre branches de ponta a ponta.
Recursos relacionados
Mais comandos do Git
