Git Checkout Remote Branch: Guia passo a passo

Quando precisamos trabalhar em uma ramificação em um repositório remoto, como o trabalho de um colega ou uma nova ramificação de recurso, enfrentamos o desafio de acessar e atualizar essa ramificação localmente.

Felizmente, Git simplifica esse processo, oferecendo comandos diretos para que você crie uma cópia local do ramo remoto. Isso nos permite mudar para a ramificação desejada, contribuir e colaborar efetivamente com a equipe.

Para obter uma resposta rápida, para fazer checkout de uma ramificação chamada , executamos:

git fetch origin <branch_name>
git checkout -b <branch_name> origin/<branch_name>

Neste artigo, exploraremos esses comandos e saberemos como eles funcionam com mais detalhes.

O processo em duas etapas: git fetch e git checkout

Para começar a trabalhar em uma ramificação remota localmente, precisamos primeiro nos certificar de que nosso repositório local esteja atualizado com o repositório remoto. Em seguida, podemos criar uma cópia local e começar a trabalhar nessa ramificação.

Atualizando o repositório local

Para atualizar o repositório local, usamos o comandogit fetch . Sua forma mais simples não usa argumentos:

git fetch

Quando usado sem argumentos, o comando git fetch recupera todas as ramificações do repositório remoto padrão. Embora isso inclua a ramificação que desejamos, também ocupará mais espaço em disco local.

Se o espaço em disco for uma preocupação, podemos especificar o ramo que queremos buscar passando-o como parâmetro para o comando:

git fetch origin <branch_name>

Substitua pelo nome da filial desejada. O parâmetro origin especifica o nome do repositório remoto. Por padrão, quando clonamos um repositório, o remoto é chamado de origem.

É importante observar que a atualização das referências remotas com fetch não afetará nenhum dos arquivos locais nem causará conflitos. Localmente, há duas entidades distintas:

• O diretório de trabalho atual
• O repositório local

Nossas alterações e confirmações atuais estão localizadas no diretório de trabalho atual. Esses são os arquivos que vemos quando abrimos o diretório do repositório em nosso computador. Eles não são atualizados com o git fetch. Somente o repositório local é atualizado, o que pode ser considerado como uma cópia oculta do repositório remoto em nosso computador local.

Verificação de uma ramificação remota

Com uma cópia atualizada do repositório remoto, agora podemos criar uma cópia local de uma ramificação remota usando o comando git checkout:

git checkout -b <branch_name> origin/<branch_name>

Substitua pelo nome da filial remota desejada. O primeiro parâmetro após -b é o nome que você deseja que a filial local tenha. Convencionalmente, usamos o mesmo nome para ambos, mas podemos usar qualquer outro nome, desde que nenhuma outra filial local tenha esse nome:

git checkout -b <local_branch_name> origin/<branch_name>

Após a execução bem-sucedida desse comando, o Git mudará o diretório de trabalho atual para esse ramo e estaremos prontos para começar a trabalhar nele.

git checkout vs git switch

O comando git checkout existe desde o início do Git. Seu escopo vai além da criação de cópias locais de ramificações ou da mudança de uma ramificação para outra. Por exemplo, ele pode obter arquivos específicos do repositório remoto.

Nas versões recentes do Git, foi criado o comando git switch, cuja única finalidade é criar cópias locais de ramificações remotas e alternar entre ramificações locais.

Recomendo que você use git switch em vez de git checkout porque os recursos estendidos de git checkout podem, às vezes, levar a erros.

Para saber como executar as mesmas ações que aprendemos neste artigo usando git switch, você pode ler este tutorial: Git Switch Branch: Um guia com exemplos práticos.

Conclusão

Criar uma cópia local de uma ramificação remota do Git é muito importante para a colaboração. Usando git fetch e git checkout, podemos atualizar nosso repositório local com alterações remotas e mudar para o ramo desejado.

Embora o clássico git checkout ofereça uma funcionalidade robusta, o novo comando git switch oferece uma alternativa simplificada especificamente para o gerenciamento de filiais, reduzindo o risco de erros.