Back

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

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 :

  1. Récupérez tous les tags :

    git fetch --tags
    
  2. 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.

Listen to your bugs 🧘, with OpenReplay

See how users use your app and resolve issues fast.
Loved by thousands of developers