Étiquettes Git

Si vous atteignez une étape importante et souhaitez toujours vous souvenir de l'instantané d'un commit, vous pouvez utilisergit tagÉtiquetez-le.

Les étiquettes Git sont utilisées pour marquer des points de commit spécifiques dans un dépôt, généralement pour les versions de publication (telles que v1.0, v2.0).

Par exemple, si nous voulons publier une version "1.0" pour notre projet d'exemple, nous pouvons utilisergit tag -a v1.0La commande étiquette le dernier commit (HEAD) avec "v1.0".

-aOptions et explications

"Créer une étiquette annotée", pas nécessaire-aCette option fonctionne aussi, mais elle n'enregistrera pas quand l'étiquette a été créée, par qui, ni ne vous permettra d'ajouter une annotation à l'étiquette. Nous recommandons de toujours créer des étiquettes annotées.

Format de syntaxe des étiquettes :

git tag <tagname>

Par exemple :

git tag v1.0

-aL'option peut ajouter une annotation :

$ git tag -a v1.0 

Lorsque vous exécutez la commande git tag -a, Git ouvrira votre éditeur et vous permettra d'écrire une annotation d'étiquette, tout comme écrire une annotation pour un commit.

Maintenant, notez que lorsque nous exécutonsgit log --decorateÀ ce stade, nous pouvons voir notre étiquette :

*   d5e9fc2 (HEAD -> master) Merge branch 'change_site'
|\  
| * 7774248 (change_site) changed the example.php
* | c68142b 修改代码
|/  
* c1501a2 removed test.txt、add example.php
* 3e92c19 add test.txt
* 3b58100 第一次版本提交

Si nous avons oublié de taguer un commit et que nous l'avons déjà publié, nous pouvons lui ajouter un tag après coup.

Par exemple, supposons que nous ayons publié le commit 85fc7e7 (la dernière ligne de l'exemple ci-dessus), mais que nous ayons oublié de le taguer à ce moment-là. Nous pouvons maintenant aussi :

$ git tag -a v0.9 85fc7e7
$ git log --oneline --decorate --graph
*   d5e9fc2 (HEAD -> master) Merge branch 'change_site'
|\  
| * 7774248 (change_site) changed the example.php
* | c68142b 修改代码
|/  
* c1501a2 removed test.txt、add example.php
* 3e92c19 add test.txt
* 3b58100 (tag: v0.9) 第一次版本提交

Si nous voulons afficher tous les tags, nous pouvons utiliser la commande suivante :

$ git tag
v0.9
v1.0

Pousser les tags vers le dépôt distant

Par défaut, git push ne pousse pas les tags ; vous devez explicitement pousser les tags.

git push origin <tagname>

Pousser tous les tags :

git push origin --tags

Supprimer un tag léger

Supprimer localement :

git tag -d <tagname>

Supprimer à distance :

git push origin --delete <tagname>

Tags annotés

Les tags annotés stockent le nom du créateur, l'adresse e-mail, la date, et peuvent contenir des informations sur le tag. Les tags annotés sont plus formels et adaptés aux scénarios qui nécessitent des métadonnées supplémentaires.

Syntaxe pour créer des tags annotés :

git tag -a <tagname> -m "message"

Par exemple :

git tag -a <tagname> -m "example.com标签"

Commande de tag signé PGP:

git tag -s <tagname> -m "example.com标签"

Afficher les informations sur le tag:

git show <tagname>

Exemple

Voici un exemple complet démontrant comment créer, afficher, pousser et supprimer des tags.

Création de tags légers et de tags annotés:

git tag v1.0
git tag -a v1.1 -m "example.com标签"

Affichage des tags et des informations sur les tags:

git tag
git show v1.1

Pousser les tags vers le dépôt distant:

git push origin v1.0
git push origin v1.1
git push origin --tags  # 推送所有标签

Supprimer le tag

Supprimer localement :

git tag -d v1.0

Supprimer à distance :

git push origin --delete v1.0

autres extensions