Como fazer Checkout de uma Tag Git (Guia Passo a Passo)

Tags Git são usadas para marcar commits específicos em seu repositório, frequentemente para releases. Se você precisa fazer checkout de uma tag, este guia irá mostrar como.

1. Listar Tags Disponíveis

Para ver todas as tags em seu repositório Git, execute:

git tag

Para informações detalhadas da tag:

git show <tag-name>

2. Fazer Checkout de uma Tag

Para mover seu diretório de trabalho para o estado de uma tag:

git checkout <tag-name>

Exemplo:

git checkout v1.2.3

Aviso de HEAD Desanexado

Ao fazer checkout de uma tag, o Git move você para um estado de HEAD desanexado, significando que:

• Você pode visualizar e modificar arquivos, mas novos commits não pertencerão a nenhum branch.
• Para retornar ao seu branch:

  git checkout main  # Ou o nome do seu branch de trabalho

3. Fazer Checkout de uma Tag e Criar um Branch (Recomendado)

Se você deseja fazer alterações baseadas em uma tag, crie um novo branch a partir dela:

git checkout -b meu-branch-feature <tag-name>

Ou usando o comando mais recente git switch:

git switch -c meu-branch-feature <tag-name>

4. Fazer Checkout de uma Tag Remota

Para fazer checkout de uma tag de um repositório remoto:

1. Busque todas as tags:

   git fetch --tags
   

2. Faça checkout da tag:

   git checkout tags/<tag-name>
   

5. Voltar para um Branch

Se você estiver em um estado de HEAD desanexado e quiser retornar:

git checkout main  # Ou qualquer nome de branch

Ou com git switch:

git switch main

Perguntas Frequentes

Conclusão

Fazer checkout de uma tag Git é útil para visualizar um snapshot do seu repositório em um ponto específico. No entanto, como tags não são branches, você deve criar um novo branch se precisar fazer alterações.