Git Switch Branch: Um guia com exemplos práticos

git switch -c feature-y

Voltar para a ramificação anterior

Muitas vezes, depois de mudar de ramificação para fazer algum trabalho, queremos voltar para a ramificação em que estávamos trabalhando anteriormente. O Git fornece uma abreviação para isso usando o comando:

git switch -

Git Switch vs. Git Switch. Checkout do Git

O comando git checkout está no Git desde o início. Antes da introdução do git switch em 2019, o git checkout era o comando usado para alternar entre as ramificações. No entanto, o escopo do comando git checkout vai além da simples navegação entre as ramificações. Aqui está um detalhamento das diferenças:

• git switch: Seu objetivo é oferecer uma maneira mais intuitiva de alternar e criar novas ramificações. Seu objetivo é simplificar o conjunto de comandos e reduzir a confusão.
• git checkout: Um comando mais versátil que pode ser usado para alternar ramificações, mas também para verificar arquivos e restaurar conteúdo de diferentes commits ou ramificações.

O design do git switch dificulta a substituição acidental de alterações. Ele tem uma sintaxe mais explícita para alternar ramificações e criar novas ramificações.

Como o git checkout faz várias coisas (troca de ramificações, restauração de arquivos etc.), há uma chance maior de você cometer erros ao usá-lo.

Git Switch: Erros comuns

Ao gerenciar filiais, você pode se deparar com alguns problemas comuns. Um deles está tentando criar uma ramificação que já existe localmente. Outro problema frequente ocorre quando você tenta mudar de ramo com alterações não confirmadas. Vamos começar explicando a primeira.

A filial já existe localmente

Cada filial local precisa de um nome exclusivo. Você pode usar o site git switch para criar filiais locais de duas maneiras:

1. Para rastrear um ramo remoto:

git switch --track origin/<branch-name>

2. Para criar uma nova filial local:

git switch -c <branch-name>

Em ambos os casos, se já houver uma ramificação local chamada , o Git apresentará um erro dizendo:

fatal: a branch named '<branch-name>' already exists

Nesse caso, podemos mudar para o ramo sem criá-lo usando git switch .

O ramo atual tem alterações não confirmadas

O Git não nos permitirá mudar de ramo se o ramo atual tiver alterações não confirmadas que seriam substituídas pela mudança. Nesse caso, o Git lançará um erro dizendo:

Please commit your changes or stash them before you switch branches.

Como a mensagem indica, para superar essa situação, precisamos primeiro confirmar nossas alterações ou armazená-las. Se as alterações estiverem prontas para serem confirmadas no repositório, devemos confirmá-las usando:

git commit -m "Commit message"

Se quisermos manter as alterações, mas ainda não estivermos prontos para fazer o commit, poderemos salvá-las temporariamente usando o comando git stash comando:

git stash

Se você armazenar as alterações antes de mudar de ramo e quiser reaplicá-las quando voltar ao ramo original, poderá usar o comando git stash pop.

Como alternativa, também podemos decidir descartar as alterações usando o sinalizador --discard-changes:

git switch --discard-changes <branch-name>

Tenha cuidado ao usar a última opção, pois as alterações serão excluídas permanentemente.

Uso avançado do Git Switch

Quando você precisa criar ramificações a partir de pontos específicos no histórico do projeto ou lidar com cenários especiais, o site git switch oferece funcionalidade avançada para atender a essas necessidades.

Ramificação a partir de um ponto específico

Por padrão, ao criar uma ramificação com git switch, o estado inicial da nova ramificação será o HEAD da ramificação em que estamos atualmente.

Imagine que você queira iniciar uma nova ramificação a partir de um commit anterior específico. Cada commit é identificado por um exclusivo, que pode ser usado com o comando git switch para criar uma nova ramificação a partir desse commit. Veja como você pode fazer isso:

switch -c feature-y <hash>

Substitua pelo hash de confirmação real.

Mudança para uma cabeça separada

Se quisermos explorar ou experimentar um commit específico sem afetar a ramificação atual ou criar uma nova ramificação, podemos usar uma cabeça separada com o comando:

git switch --detach <hash>

Ao desanexar o cabeçalho, podemos inspecionar com segurança o estado do repositório em um commit específico, executar testes ou fazer alterações temporárias sem o risco de que essas alterações sejam acidentalmente confirmadas no branch de trabalho atual. Os casos de uso mais comuns incluem:

• Visualização de um estado antigo: Se quisermos inspecionar ou testar um commit mais antigo sem fazer alterações no branch atual, podemos mudar para esse commit em um estado desanexado.
• Alterações temporárias: Se quisermos fazer experiências com alterações sem afetar nenhuma ramificação, podemos fazer essas alterações em um estado de cabeça separada. Observe que todos os novos commits que fizermos nesse estado não pertencerão a nenhum branch, e talvez seja necessário criar um novo branch se quisermos manter esses commits.
• Finalidades de construção/teste: Às vezes, precisamos criar ou testar o software em um commit específico. A mudança para um estado HEAD desanexado nesse commit nos permite fazer isso sem nenhum impacto na estrutura de ramificação do repositório.

Forçar uma troca

Aprendemos que o Git não nos permite mudar de ramo se houver alterações não confirmadas que possam entrar em conflito com o ramo de destino. Se tivermos certeza de que queremos descartar essas alterações e prosseguir com a mudança, podemos forçá-la usando a opção -f, assim:

git switch -f <branch-name>

Há ressalvas importantes a serem consideradas. 

• Todas as alterações não confirmadas serão perdidas sem aviso, podendo resultar em perda de trabalho se essas alterações não tiverem sido salvas em outro lugar. 
• O uso indiscriminado do site -f pode promover a falta de disciplina, incentivando os desenvolvedores a ignorar as práticas adequadas de controle de versão, como armazenar ou enviar alterações WIP (work-in-progress). Isso pode levar a um histórico caótico do repositório e complicar a colaboração. Portanto, embora o site git switch -f ofereça velocidade e conveniência, ele deve ser usado criteriosamente e com um entendimento claro dos riscos para atenuar as possíveis desvantagens.

Conclusão

O comando git switch facilita a troca e a criação de ramificações em comparação com o antigo comando git checkout.

Ele simplifica o processo e ajuda a reduzir erros, facilitando o gerenciamento da base de código pelos desenvolvedores.

Esse comando ajuda a evitar problemas comuns, como a substituição acidental de alterações ou a confusão de diferentes funções do git checkout.

A adoção desse comando pode tornar a navegação nas ramificações do Git mais intuitiva e aumentar a colaboração entre as equipes de desenvolvimento.