Como renomear o branch Git padrão e por que você deseja

Se você já usa o Git há algum tempo, provavelmente já encontrou o termo mestre. Você pode ter visto quando corre git status ou branch git.

É uma frase um tanto antiquada e você pode estar se perguntando de onde vem ou como pode mudá-la. Seja você um usuário de linha de comando ou um fã do GitHub, você pode alterar os nomes dos ramos e até mesmo definir o nome do ramo padrão para algo apropriado às suas necessidades.

Qual é a ramificação padrão?

Cada novo repositório Git tem um branch padrão, mesmo que ele realmente não ramifique nada! Ramificações são simplesmente referências de commit, e sempre há uma referência HEAD apontando para a ramificação atual.

Historicamente, o Git nomeou esse branch padrão mestre. Embora você possa renomeá-lo, muitas pessoas mantêm o padrão, então você verá muitos projetos usando o master como branch padrão.

Nomenclatura de filiais e por que o mestre está sendo eliminado

Versões recentes do Git (2.28 e posteriores) produzem a seguinte dica quando você cria um novo repositório usando git init:

Usando 'master' como nome para o branch inicial. Este nome de filial padrão está sujeito a alterações. Para configurar o nome do branch inicial a ser usado em todos os seus novos repositórios, o que suprimirá esse aviso, chame: git config --global init.defaultBranch Os nomes comumente escolhidos em vez de 'mestre' são 'principal', 'tronco' e 'desenvolvimento'. O branch recém-criado pode ser renomeado por meio deste comando: git branch -m

A terminologia mestre / escravo tem uma longa história na computação, especialmente em referência a hardware, como unidades de disco. Outros sistemas de controle de versão, como BitKeeper, um predecessor do Git, também usaram o termo. No entanto, o termo tornou-se um tanto desatualizado por sua associação com o colonialismo.

Os mantenedores do Git trabalharam com a comunidade de desenvolvimento mais ampla para tratar dessas questões. Além de qualquer ofensa que possa causar, mestre não é um nome particularmente descritivo de qualquer maneira. Implica um relacionamento com alguma outra entidade sem nome, mas não representa o status exclusivo do branch inicial. Muitas pessoas consideram o nome a Principal para fazer um trabalho melhor ao descrever este branch e seu uso típico.

O nome main é curto, traduz-se facilmente e é de uso comum. O fato de começar com as mesmas duas letras de master pode ajudar se você precisar treinar novamente a memória muscular.

Como fazer a mudança usando o Git de linha de comando

Como o próprio Git explica, você pode configurar o nome do branch padrão com o seguinte comando:

git config --global init.defaultBranch main

O --global garante que essa configuração se aplique a todos os repositórios criados pelo usuário atual.

Veja também: Como instalar e configurar o Git no Linux

Depois de definidos, os novos repositórios usarão o novo nome padrão:

$ git init
Repositório Git vazio inicializado em /private/tmp/bar/.git/
$ git status -sb
## Nenhum commit ainda no principal

Observe que você também pode renomear uma filial a qualquer momento usando a opção -m, por exemplo

git branch -m main

Um dia, o Git pode fazer essa mudança para você, usando o nome a Principal por padrão, para todos os novos repositórios. Ainda é útil saber como alterá-lo sozinho, e você pode ter uma preferência pessoal ou da equipe por um nome diferente a Principal.

Como definir o nome do branch padrão no GitHub

Ramificações criadas no GitHub agora são automaticamente nomeadas como principais em vez de mestre. No entanto, você ainda pode alterar o nome desse padrão seguindo estas etapas:

1. Aberto Configurações por meio de sua foto de perfil no canto superior direito.
2. Clique Repositórios no menu à esquerda.
3. Debaixo de Ramificação padrão do repositório seção, escolha um nome alternativo.
4. Clique Atualizar.

Relacionado: O que é GitHub? Uma introdução aos seus recursos básicos

Assuma o controle do nome do branch padrão do Git

O Git historicamente nomeou seu branch padrão mestre, mas você não precisa mantê-lo assim!

Se você acha que uma alternativa é mais inclusiva, mais fácil de entender ou simplesmente mais curta para digitar, é fácil mudar. O branch padrão é apenas uma pequena parte do enorme repertório do Git. Para levar sua habilidade em Git do iniciante ao avançado, confira nosso guia abrangente a seguir.

Tutorial Git Avançado

Leve sua habilidade em Git do iniciante ao avançado com este guia abrangente.

Leia a seguir

Sobre o autor