Git Tag
Dernière mise à jour
git tag marque un commit spécifique avec un nom - généralement une version de publication comme v1.0.0. Les étiquettes existent sous deux formes : légères (juste un nom pointant vers un commit) et annotées (un objet complet avec un message, un auteur et une date). Les étiquettes ne sont pas poussées automatiquement, vous les poussez donc séparément.
Essayez-les dans le terminal playground - un vrai shell dans votre navigateur, rien à installer.
Syntaxe
| Command | What it does |
|---|---|
git tag v1.0.0 | Créer une étiquette légère sur HEAD |
git tag -a v1.0.0 -m "Release 1.0" | Créer une étiquette annotée avec un message |
git tag -a v1.0.0 <hash> | Étiqueter un commit passé spécifique |
git tag | Lister toutes les étiquettes |
git push origin v1.0.0 | Pousser une étiquette vers le distant |
git push --tags | Pousser toutes les étiquettes |
git tag -d v1.0.0 | Supprimer une étiquette locale |
lightweight vs annotated
| Lightweight | Annotated | |
|---|---|---|
| Stocke un message | Non | Oui |
| Enregistre l'auteur et la date | Non | Oui |
| Adaptée aux publications | Non | Oui |
FAQ git tag
Comment créer une étiquette dans Git ?
Pour un marqueur rapide, exécutez
git tag <name> (une étiquette légère sur le commit actuel). Pour une publication, créez une étiquette annotée : git tag -a v1.0.0 -m "Release 1.0", qui stocke un message, un auteur et une date. Ajoutez un hash de commit à la fin pour étiqueter un commit plus ancien.Quelle est la différence entre les étiquettes légères et annotées ?
Une étiquette légère n'est qu'un nom pointant vers un commit - sans données supplémentaires. Une étiquette annotée est un objet Git complet avec un message, le nom de l'étiqueteur et une date, et elle peut être vérifiée. Utilisez les étiquettes annotées pour les publications ; les étiquettes légères conviennent aux marqueurs temporaires ou privés.
Comment pousser des étiquettes vers le distant ?
Les étiquettes ne sont pas incluses dans un
git push normal. Poussez une étiquette spécifique avec git push origin <tagname>, ou poussez toutes les étiquettes en une fois avec git push --tags. Cela déroute les gens - une étiquette que vous avez créée reste locale jusqu'à ce que vous la poussiez.Comment supprimer une étiquette ?
Supprimez une étiquette locale avec
git tag -d <tagname>. Pour la retirer aussi du distant, exécutez git push origin --delete <tagname> (ou l'ancien git push origin :refs/tags/<tagname>). Les suppressions d'étiquettes locales et distantes sont des étapes distinctes.Puis-je m'entraîner en ligne ?
Oui. Ouvrez le terminal playground pour exécuter
git tag dans un vrai shell dans votre navigateur - rien à installer. Le cours Git interactif et gratuit de Coddy couvre aussi l'étiquetage et les publications étape par étape.Ressources associées
Plus de commandes Git
