{"id":15308,"date":"2020-08-05T11:35:00","date_gmt":"2020-08-05T14:35:00","guid":{"rendered":"https:\/\/blog.hostinger.io\/br-tutoriais\/?p=15308"},"modified":"2025-12-18T11:47:57","modified_gmt":"2025-12-18T14:47:57","slug":"renomear-branch-git","status":"publish","type":"post","link":"\/br\/tutoriais\/renomear-branch-git","title":{"rendered":"Como renomear um branch local ou remoto do Git: guia de reposit\u00f3rios Git"},"content":{"rendered":"

O Git é um Sistema de Controle de Versão (VCS)<\/strong> usado por desenvolvedores para facilitar colaborações. Ele é extremamente útil para coordenar trabalhos em grupo e monitorar mudanças no código-fonte durante o processo de desenvolvimento.<\/p>

Quando você está trabalhando no Git, é comum usar branches para adicionar novos recursos ou corrigir bugs, pois um branch permite que você faça mudanças no projeto sem alterar o código original. Quando você se certifica de que um branch está funcionando corretamente, é possível combiná-lo com o branch principal.<\/p>

Nos parágrafos abaixo, vamos explicar o que são repositórios e branches Git. Também explicaremos como renomear branches Git locais ou remotos, caso você dê um nome incorreto a algum deles ou queira reorganizar seu projeto. Também compartilharemos alguns comandos úteis neste processo.<\/p>

Vamos lá?<\/p>

\n\n\n\n\n\n\n<\/p>

O Que é um Repositório Git?<\/strong><\/h2>

O Git permite que todos os membros da equipe acesso à versão final de um projeto. Ele foi projetado com foco em desempenho, segurança e flexibilidade para facilitar o gerenciamento de projetos.<\/p>

Ao aprender os conceitos básicos do Git<\/a>, você se deparará com o termo repositório<\/strong>. O repositório funciona como uma pasta para o seu projeto e contém todos os seus arquivos, bem como o histórico de revisões. Os repositórios podem ser privados ou públicos e podem ser compartilhados com outras pessoas.<\/p>

Quando você cria um repositório Git, um diretório .git\/ <\/strong>aparece na raiz da pasta do projeto. Aqui, o Git rastreia as alterações dos arquivos do projeto, armazena objetos, referências<\/strong><\/a> e informações adicionais de gerenciamento do repositório.<\/p>

Tenha cuidado para não excluir a pasta .git\/ <\/strong>por <\/strong>acidente, pois isso resultará na perda do histórico do projeto.<\/p>

Recomendamos usar o GitHub<\/strong><\/a> como local centralizado para seus repositórios, pois seus recursos facilitam a colaboração e permitem que os usuários gerenciem o código com mais eficiência.<\/p>

O Que É um Branch<\/em> no Git?<\/strong><\/h2>

No Git, branches são faixas isoladas do desenvolvimento do seu projeto. Elas proporcionam uma maneira de trabalhar junto com o branch principal sem afetá-lo, mantendo a organização e evitando que você adicione códigos que ainda não estejam prontos ao seu projeto definitivo.<\/p>

Um branch funciona como um apontamento para um commit<\/strong><\/a> – isto é, um snapshot<\/em> das alterações que você fez ou deseja fazer no seu projeto —, o que é muito útil quando você deseja adicionar outros recursos ou corrigir um bug. É possível criar, excluir e listar branches<\/em>.<\/p>

Os branches também impedem que códigos instáveis, ainda em desenvolvimento ou testes, sejam mesclados com o código principal de um projeto. <\/p>

Como Renomear um Branch Local do Git<\/strong><\/h2>

Antes de começarmos, garanta que você selecionou o branch que deseja renomear:<\/span><\/p>

git checkout nome-antigo<\/span><\/pre>
Se você quer ver todos os seus branches locais, use o seguinte comando:<\/span><\/p>
git branch --list<\/span><\/pre>
Quando você tiver feito isso, siga os seguintes passos:<\/span><\/p>
    \n
  1. Usando o comando Git branch<\/strong>, adicione uma opção -m <\/strong>à sua linha:<\/li>\n<\/ol>
    git branch -m novo-nome<\/pre>
      \n
    1. Como alternativa, você pode renomear uma ramificação local executando os seguintes comandos:<\/li>\n<\/ol>
      git checkout master<\/pre>
      Em seguida, renomeie a ramificação executando:<\/p>
      git branch -m nome-antigo novo-nome<\/pre>
        \n
      1. Por fim, execute este comando para listar todas as ramificações locais e remotas do Git e verifique se a renomeação foi bem-sucedida:<\/li>\n<\/ol>
        git branch -a<\/pre>
        Como Renomear um Branch Remoto do Git<\/strong><\/h2>
        Ao contrário de um branch local, não é possível renomear um branch remoto diretamente. Em vez disso, você precisa remover o nome antigo do branch remoto e aplicar o comando push<\/a> para o novo nome no repositório remoto.<\/p>
        O processo é simples — basta seguir os passos abaixo:<\/p>
          \n
        1. Para começar, você precisará renomear um branch local seguindo as etapas anteriores usando a opção -m<\/strong>.<\/li>\n\n\n\n
        2. Em seguida, exclua o branch antigo <\/strong>e envie o novo usando o comando push<\/strong>. Faça isso inserindo o seguinte comando:<\/li>\n<\/ol>
          git push origin --delete nome-antigo<\/pre>
            \n
          1. Termine redefinindo o upstream branch para o novo branch local:<\/li>\n<\/ol>
            git push origin -u novo-nome<\/pre>
            Como alternativa, você pode renomear um branch remoto do git simplesmente substituindo-o, o que pode ser feito com o comando abaixo:<\/p>
            git push origin :nome-antigo novo-nome
            git push origin -u novo-nome<\/pre>
            Como Criar um Novo Branch Local do Git<\/strong><\/h2>
            Antes de criar uma nova ramificação, é essencial entender o que é um Git commit<\/strong>. Trata-se de um comando que salva as alterações em um repositório local. O Git commit <\/strong>captura snapshots das alterações que ocorrem em um projeto específico.<\/p>
            Quando você cria um novo branch local, o Git estabelece um apontamento para ele.<\/p>
            Nós podemos criar um novo branch seguindo os passos abaixo.<\/span><\/p>
              \n
            1. Navegue até a raiz do seu master branch:<\/li>\n<\/ol>
              cd nome-do-repositorio<\/pre>
                \n
              1. Crie um novo branch com o seguinte comando:<\/li>\n<\/ol>
                git branch nome-do-novo-branch<\/pre>
                  \n
                1. Como alternativa, você pode criar um novo branch e mudar para ele usando o comando checkout<\/strong>:<\/li>\n<\/ol>
                  git checkout -b nome-do-novo-branch<\/pre>
                  A opção -b <\/strong>diz ao Git para executar o comando Git branch <\/strong>antes do Git checkout<\/strong>.<\/p>
                  Em vez disso, você pode clonar um branch e mudar para ele:<\/p>
                  git checkout -b nome-do-novo-branch origin\/nome-do-novo-branch<\/pre>
                    \n
                  1. Em seguida, mude para seu novo branch:<\/li>\n<\/ol>
                    git checkout nome-do-novo-branch<\/pre>
                      \n
                    1. Por fim, verifique se você está no novo branch usando o comando abaixo:<\/li>\n<\/ol>
                      git status<\/pre>
                      Como Excluir um Branch Local do Git?<\/strong><\/h2>
                      Quando uma tarefa é finalizada e pode ser mesclada com o projeto principal, é recomendável excluir os branches <\/strong>usados no desenvolvimento, pois eles não tem mais serventia e podem deixar seu código bagunçado.<\/p>
                      Observe que o Git se recusará<\/strong> a excluir um branch que contenha commits que não tenham sido mesclados em um branch remoto ou em um repositório.<\/p>
                      Para remover um branch local, use um dos seguintes comandos do Git<\/strong><\/a>:<\/p>
                      git branch -d nome_do_branch<\/pre>
                      git branch -D nome_do_branch<\/pre>
                      A opção -d (-delete<\/strong>) removerá seu branch local se você já o tiver enviado e mesclado com o branch remoto. Já a opção -D (-delete -force<\/strong>) removerá o branch local, independentemente de ele ter sido mesclado ou não.<\/p>
                      Como Excluir um Branch Remoto do Git?<\/strong><\/h2>
                      Você também pode remover um branch remoto ao especificar os nomes tanto do repositório remoto quanto do branch. Na maioria dos casos, o nome do repositório remoto é origin<\/strong>, e o comando ficará assim:<\/p>
                      git push origin --delete nome-do-branch
                      git push origin :nome_do_branch<\/pre>
                      Inspeção e Comparação<\/strong><\/h2>
                      No Git, você pode visualizar quaisquer mudanças que você fez a qualquer momento. Para ver essas mudanças, insira o seguinte comando:<\/p>
                      git log<\/pre>
                      Ou, para um resumo mais detalhado:<\/p>
                      git log --summary<\/pre>
                      Esses comandos retornarão uma lista de todos os commits feitos em um repositório.<\/p>
                      Se você estiver procurando por um commit específico, analisar cada um deles pode ser muito demorado. Felizmente, existem algumas opções que você pode usar para filtrar seus resultados:<\/p>