Git Branch
Última atualização
git branch é o comando para gerenciar branches: ele os lista, os cria, os exclui e os renomeia. Sozinho, ele lista seus branches locais com o atual marcado. Observe que git branch feature apenas cria um branch; para mudar para ele, use git switch ou git checkout.
Experimente estes comandos no terminal playground: um shell real no seu navegador, sem nada para instalar.
Sintaxe
| Command | What it does |
|---|---|
git branch | Lista os branches locais |
git branch -a | Lista os branches locais e remotos |
git branch feature | Cria um branch (sem mudar para ele) |
git branch -d feature | Exclui um branch mesclado |
git branch -D feature | Força a exclusão de um branch não mesclado |
git branch -m newname | Renomeia o branch atual |
git branch --merged | Lista os branches mesclados no HEAD |
Casos comuns
| Goal | Command |
|---|---|
| Ver todos os branches, incluindo os remotos | git branch -a |
| Ver o upstream de cada branch | git branch -vv |
| Limpar os branches mesclados | git branch --merged |
| Criar e mudar em uma só etapa | git switch -c feature |
Perguntas frequentes sobre o git branch
Como listo todos os branches no Git?
Execute
git branch para listar os branches locais, com um asterisco marcando aquele em que você está. Adicione -a (git branch -a) para incluir os branches de rastreamento remoto, ou -r para listar apenas os branches remotos. Use git branch -vv para ver também o upstream de cada branch e o status à frente/atrás.O git branch cria e muda para o branch?
Não:
git branch feature apenas cria o branch; você continua onde está. Para criar e mudar em uma só etapa, use git switch -c feature (ou o mais antigo git checkout -b feature). O git branch puro é para gerenciamento, não para navegação.Como excluo um branch?
Use
git branch -d <name> para excluir um branch cujo trabalho está mesclado (o Git recusa caso contrário, protegendo os commits não mesclados), ou git branch -D <name> para forçar a exclusão de qualquer forma. Você não pode excluir o branch em que está atualmente: mude para outro primeiro.Como renomeio um branch?
Execute
git branch -m <newname> para renomear o branch atual, ou git branch -m <oldname> <newname> para renomear outro. Se o branch já foi enviado, você também precisará atualizá-lo no remoto: veja a página do git rename branch.Posso praticar isso online?
Sim. Abra o terminal playground para executar
git branch em um shell real no seu navegador, sem nada para instalar. O curso interativo e gratuito de Git da Coddy também cobre o uso de branches passo a passo.