O Que são Branches?

Pense no seu código como uma linha do tempo principal (quase sempre chamada main ou master). Quando você quer desenvolver uma nova funcionalidade, corrigir um bug, ou experimentar uma ideia sem bagunçar o código principal, você cria uma branch.

Uma branch é como uma "ramificação" dessa linha do tempo. Ela permite que você trabalhe em isolamento, faça suas mudanças, adicione commits, e só depois (se tudo estiver funcionando) integre de volta à linha do tempo principal.

• Por que usar branches?
  • Isolamento: Suas alterações são isoladas e não afetam o código principal (e vice-versa) até que você decida uni-las.
  • Colaboração: Múltiplos desenvolvedores podem trabalhar em diferentes funcionalidades simultaneamente, cada um em sua própria branch, sem interferir no trabalho dos outros.
  • Experimentação: Permite testar novas ideias ou abordagens radicais sem risco para a estabilidade do projeto principal.
  • Organização do Histórico: Mantém o histórico do seu código limpo e organizado, com commits específicos para cada funcionalidade ou correção.

A branch main (ou master) é considerada a branch principal do seu repositório. Idealmente, é onde o código está estável e pronto para ser entregue aos usuários ou publicado. A boa prática é nunca trabalhar diretamente na main para novas funcionalidades ou correções de bugs.

Listando Branches (git branch)

Este comando mostra todas as branches existentes no seu repositório local.

• Comando:

  git branch
  
  

• Saída Exemplo: O asterisco () indica a branch em que você está atualmente.

  * main
    feature/nova-funcionalidade
  
  

Criando uma Nova Branch (git switch -c <nome-da-branch>)

Para começar a trabalhar em uma nova funcionalidade, você deve criar uma branch a partir da branch onde você quer que as mudanças se baseiem (geralmente main).

• Comando (Criar e Trocar para a Nova Branch):

  git switch -c feature/adiciona-autenticacao
  
  

  • Explicação:
    • git switch: O comando moderno e recomendado para trocar de branches.
    • c (ou -create): Diz ao Git para criar uma nova branch se ela não existir.
  • Convenção de Nomes: É uma boa prática usar nomes descritivos e, muitas vezes, prefixos como:
    • feature/: Para novas funcionalidades (ex: feature/adiciona-carrinho).
    • bugfix/: Para correções de bugs (ex: bugfix/corrige-login).
    • hotfix/: Para correções urgentes em produção.
    • refactor/: Para refatorações de código.

Alternando entre Branches (git switch <nome-da-branch>)

Depois de criar ou se você já tem branches existentes, você precisa "mudar" para a branch em que deseja trabalhar.

• Comando:

  git switch main # Troca para a branch 'main'
  git switch feature/adiciona-autenticacao # Troca para sua branch de feature
  
  

• Atenção: Se você tiver mudanças não salvas (não comitadas) na branch atual, o Git pode recusar a troca de branch para evitar a perda dessas mudanças. Comite ou salve (stash) suas alterações antes de trocar de branch.

O Que é Merge?

Quando você termina de trabalhar em uma funcionalidade em sua branch de feature (e ela foi testada e está funcionando), você precisa "fundir" (unir) essas mudanças de volta na branch principal (main) do projeto. Este processo é chamado de merge.

• Processo Básico de Merge:

  1. Vá para a branch que vai RECEBER as mudanças: (Geralmente a main)

     git switch main
     
     

  2. Puxe as últimas atualizações da branch principal do repositório remoto: Isso é crucial para garantir que você tem a versão mais recente da main antes de integrar suas mudanças, minimizando conflitos.

     git pull origin main
     
     

  3. Faça o merge da sua branch de feature na branch main:

     git merge feature/adiciona-autenticacao
     
     

  4. Resolução de Conflitos (Se Ocorrerem): O Git tentará combinar as mudanças automaticamente.

     • Se não houver conflitos (mudanças na mesma linha de código em ambas as branches), ele fará o merge automaticamente e criará um novo commit de merge.
     • Se houver conflitos, o Git indicará quais arquivos estão conflitantes. Você precisará editá-los manualmente para resolver as divergências (veja seção sobre Conflitos).

  5. Envie as mudanças da main para o GitHub: Para que o repositório remoto reflita o merge.

     git push origin main