Git Tag
Última atualização
git tag marca um commit específico com um nome - geralmente uma versão de lançamento como v1.0.0. As tags vêm em duas formas: leves (apenas um nome apontando para um commit) e anotadas (um objeto completo com uma mensagem, autor e data). As tags não são enviadas automaticamente, então você as envia separadamente.
Experimente estes no terminal playground - um shell real no seu navegador, nada para instalar.
Sintaxe
| Command | What it does |
|---|---|
git tag v1.0.0 | Criar uma tag leve no HEAD |
git tag -a v1.0.0 -m "Release 1.0" | Criar uma tag anotada com uma mensagem |
git tag -a v1.0.0 <hash> | Marcar um commit anterior específico |
git tag | Listar todas as tags |
git push origin v1.0.0 | Enviar uma tag para o remoto |
git push --tags | Enviar todas as tags |
git tag -d v1.0.0 | Excluir uma tag local |
lightweight vs annotated
| Lightweight | Annotated | |
|---|---|---|
| Armazena uma mensagem | Não | Sim |
| Registra autor e data | Não | Sim |
| Boa para lançamentos | Não | Sim |
Perguntas frequentes sobre git tag
Como crio uma tag no Git?
Para um marcador rápido, execute
git tag <name> (uma tag leve no commit atual). Para um lançamento, crie uma tag anotada: git tag -a v1.0.0 -m "Release 1.0", que armazena uma mensagem, autor e data. Adicione um hash de commit no final para marcar um commit mais antigo.Qual é a diferença entre tags leves e anotadas?
Uma tag leve é apenas um nome apontando para um commit - sem dados extras. Uma tag anotada é um objeto Git completo com uma mensagem, nome do autor e data, e pode ser verificada. Use tags anotadas para lançamentos; tags leves são adequadas para marcadores temporários ou privados.
Como envio tags para o remoto?
As tags não são incluídas em um
git push normal. Envie uma tag específica com git push origin <tagname>, ou envie todas as tags de uma vez com git push --tags. Isso confunde as pessoas - uma tag que você criou permanece local até você enviá-la.Como excluo uma tag?
Exclua uma tag local com
git tag -d <tagname>. Para removê-la também do remoto, execute git push origin --delete <tagname> (ou o antigo git push origin :refs/tags/<tagname>). As exclusões de tags locais e remotas são etapas separadas.Posso praticar isso online?
Sim. Abra o terminal playground para executar
git tag em um shell real no seu navegador - nada para instalar. O curso interativo e gratuito de Git da Coddy também cobre tags e lançamentos passo a passo.