Comment extraire (checkout) un tag Git (guide étape par étape)

Les tags Git sont utilisés pour marquer des commits spécifiques dans votre dépôt, souvent pour des releases. Si vous avez besoin d’extraire un tag, ce guide vous montrera comment faire.
Points clés
git checkout <tag>
vous permet de voir le code à un tag spécifique.- Vous vous retrouvez dans un état HEAD détaché, ce qui signifie que les modifications ne seront pas liées à une branche.
- Pour un développement actif, utilisez
git switch -c <branch> <tag>
pour créer une nouvelle branche à partir du tag.
1. Lister les tags disponibles
Pour voir tous les tags dans votre dépôt Git, exécutez :
git tag
Pour des informations détaillées sur les tags :
git show <tag-name>
2. Extraire un tag
Pour déplacer votre répertoire de travail vers l’état d’un tag :
git checkout <tag-name>
Exemple :
git checkout v1.2.3
Avertissement HEAD détaché
Lorsque vous extrayez un tag, Git vous déplace vers un état HEAD détaché, ce qui signifie :
- Vous pouvez afficher et modifier des fichiers, mais tous les nouveaux commits n’appartiendront pas à une branche.
- Pour revenir à votre branche :
git checkout main # Ou le nom de votre branche de travail
3. Extraire un tag et créer une branche (recommandé)
Si vous voulez faire des modifications basées sur un tag, créez une nouvelle branche à partir de celui-ci :
git checkout -b ma-branche-fonctionnalite <tag-name>
Ou en utilisant la nouvelle commande git switch
:
git switch -c ma-branche-fonctionnalite <tag-name>
4. Extraire un tag distant
Pour extraire un tag d’un dépôt distant :
-
Récupérez tous les tags :
git fetch --tags
-
Extrayez le tag :
git checkout tags/<tag-name>
5. Revenir à une branche
Si vous êtes dans un état HEAD détaché et que vous voulez revenir :
git checkout main # Ou n'importe quel nom de branche
Ou avec git switch
:
git switch main
FAQ
Parce qu'un tag n'est pas une branche - c'est juste un pointeur vers un commit. Vous devez créer une branche si vous voulez faire des modifications.
Pas directement. Vous devez d'abord créer une branche en utilisant `git checkout -b nouvelle-branche <tag>`.
`git checkout` est plus ancien et utilisé à la fois pour les branches et les fichiers. `git switch` est une alternative plus récente et plus claire pour changer de branche.
Conclusion
L’extraction d’un tag Git est utile pour visualiser un instantané de votre dépôt à un point spécifique. Cependant, comme les tags ne sont pas des branches, vous devez créer une nouvelle branche si vous avez besoin d’apporter des modifications.