Como Renomear um Branch Local ou Remoto do Git – Um Guia Rápido

Como Renomear um Branch Local ou Remoto do Git – Um Guia Rápido

Quando você está trabalhando no Git, às vezes acaba nomeando acidentalmente um branch do jeito errado, ou simplesmente quer que seu projeto fique mais organizado. Esses são incidentes bastante comuns, então vamos falar sobre como renomear tanto branches do Git locais quanto os remotos.

Também vamos explicar brevemente o que são repositórios do Git e mencionar alguns outros comandos úteis.

Como Renomear um Branch Local do Git?

Antes de começarmos, garanta que você selecionou o branch que deseja renomear:

git checkout nome-antigo

Se você quer ver todos os seus branches locais, use o seguinte comando:

git branch --list

Quando você tiver feito isso, siga os seguintes passos:

  1. Usar o comando de renomear branch do Git vai exigir que você adicione a opção -m para o seu comando::
    git branch -m novo-nome
  2. Você também pode renomear um branch local a partir de outro branch ao usar os seguintes comandos:
    git checkout master
    git branch -m nome-antigo novo-nome
  3. Finalmente, este comando irá listar todos os branches – tanto locais quanto remotos – para verificar que eles foram renomeados:

git branch -a

Como Renomear um Branch Remoto do Git?

Não é possível renomear um branch remoto diretamente. O processo de renomeação envolve seguir três etapas:

  1. Para começar, você vai precisar renomear um branch local ao seguir os passos anteriores.
  2. Então delete o branch antigo e faça o push do novo. Você pode fazer isso facilmente através dos seguintes comandos:
    git push origin --delete nome-antigo
    git push origin :old-name novo-nome
  3. Redefina o upstream branch para o seu novo branch local e estará tudo pronto:
git push origin -u novo-nome

Como Criar um Novo Branch Local do Git?

Antes de criar um novo branch, lembre-se que cada repositório, que iremos comentar depois, contém um master branch e tudo o que o Git está fazendo é apenas criar um novo apontamento.

Nós podemos criar um novo branch ao seguir os passos abaixo.

  1. Navegue até a raiz do seu master branch:
    cd nome-do-repositório
  2. Você pode criar um branch a partir de um master branch com o seguinte comando:
    git branch nome-do-novo-branch
    Ou você pode criar um novo branch e mudar para ele:
    git checkout -b nome-do-novo-branch
    Você também pode clonar um branch e então trocar para ele:
    git checkout -b nome-do-novo-branch origin/nome-do-novo-branch
  3. Troque para o seu novo branch:
    git checkout nome-do-novo-branch
  4. Finalmente, verifique que você está no novo branch:
git status

Como Excluir um Branch Local do Git?

Para excluir um branch local, você pode usar um dos seguintes comandos do Git:

git branch -d nome_do_branch
git branch -D nome_do_branch

A opção -d (–delete) vai remover o seu branch local se você já fez o push e o merge com o branch remoto.

Já a opção -D  (–delete –force) vai remover a branch local independentemente de você ter feito os processos de push ou de merge com o branch remoto.

Como Excluir um Branch Remoto do Git?

Você também pode remover um branch remoto ao especificar os nomes tanto do branch remoto quanto do local. Na maioria dos casos, o nome remoto é a origem, e o comando ficará assim:

git push nome_remoto --delete nome_do_branch
git push nome_remoto :nome_do_branch

Inspeção e Comparação

No Git, você pode visualizar quaisquer mudanças que você fez a qualquer momento. Para ver essas mudanças, insira o seguinte comando:

git log

Ou, para um resumo mais detalhado:

git log --summary

O Que é um Branch do Git?

O Git é um sistema distribuído de controle de versões (DVCS), onde todos os membros dentro de uma equipe possuem uma versão completa do projeto. Ele é projetado especificamente com desempenho, segurança e flexibilidade em mente – ainda mais quando estamos falando de gestão de projetos.

Os branches são uma linha isolada do desenvolvimento do seu projeto. Eles são uma maneira de trabalhar junto da sua master branch, mas ficam livres de qualquer código que não esteja totalmente pronto. Os branches ajudam a limpar um histórico muito desorganizado antes de você executar o merge.

O processo de branching do Git ajuda você a criar, deletar e listar outros branches. Contudo, um branch também funciona como um apontamento para o snapshot das mudanças que você promoveu – ou deseja promover – nos arquivos do projeto. Ele é útil em situações onde você quer adicionar um recurso extra ou consertar um bug dentro do projeto.

Um branch não apenas captura as mudanças, como também garante que um código instável não se juntará aos arquivos do projeto principal. Uma vez que você tiver terminado de atualizar o código de um branch, você pode fazer o merge do branch que funciona com o master branch.

O Que é um Repositório Git?

Um repositório é como uma pasta do seu projeto que armazena todos os arquivos e históricos. Eles podem ser privados ou públicos. Você também pode compartilhar repositórios com outras pessoas em sua organização.

Quando você inicia um repositório Git, um diretório .git/ é criado na pasta raíz do projeto. Aqui é onde você acompanha mudanças feitas nos arquivos, armazena objetos, referências e outras informações para gerenciar repositórios.

Só tome cuidado para não deletar a pasta .git/, a não ser que isso seja feito de propósito, porque você vai deletar todo o histórico do seu projeto.

Como Clonar um Repositório Git?

Para clonar um repositório utilize a opção clone do comando Git. Você também precisa especificar a URL do repositório:

  1. Você pode clonar o branch master do repositório remoto usando HTTPS ou SSH.
    Para o
    HTTPS:
    git clone https://github.com/nome_de_usuario/seus_apps.git
    Para o SSH:
    git clone ssh://github.com/nome-de-usuario/nome-do-repositorio.git
  2. Para navegar até o root do repositório clonado, use o comando cd:
    cd seus_apps
  3. A verificação do status do Branch pode ser feita facilmente com o seguinte comando Git:
git status

Informações Adicionais sobre o Git

Se você precisar de informações sobre como usar o Git, existe uma documentação oficial disponível online. Também confira o nosso artigo sobre comandos Git básicos, como usar um terminal PuTTY SSH para se conectar à sua conta de hospedagem ou servidor VPS, como instalar o Git no Ubuntu e um guia abrangente sobre o GitHub.

Conclusão

Resumo

É isso! Agora você pode gerenciar os branches do Git utilizando comandos. Você pode renomear um branch do Git, criar um, listar os branches existentes e até excluir. Esperamos que você tenha achado este tutorial útil!

Author
O autor

Carlos E.

Carlos Estrella é formado em jornalismo pela UFSC e tem as funções de redator, tradutor e SEO na Hostinger Brasil. Já trabalhou com jornalismo de games e tecnologia e hoje aplica essa experiência escrevendo posts e tutoriais no blog da Hostinger. Suas paixões incluem games, dar rolês com a namorada e amigos e ler artigos aleatórios da Wikipédia de madrugada.