Cómo hacer checkout de una etiqueta de Git (Guía paso a paso)

Las etiquetas de Git se utilizan para marcar commits específicos en su repositorio, a menudo para lanzamientos. Si necesita hacer checkout de una etiqueta, esta guía le mostrará cómo hacerlo.

1. Listar etiquetas disponibles

Para ver todas las etiquetas en su repositorio de Git, ejecute:

git tag

Para obtener información detallada de las etiquetas:

git show <tag-name>

2. Hacer checkout de una etiqueta

Para mover su directorio de trabajo al estado de una etiqueta:

git checkout <tag-name>

Ejemplo:

git checkout v1.2.3

Advertencia de HEAD desconectado

Al hacer checkout de una etiqueta, Git lo mueve a un estado HEAD desconectado, lo que significa:

• Puede ver y modificar archivos, pero cualquier nuevo commit no pertenecerá a una rama.
• Para volver a su rama:

  git checkout main  # O el nombre de su rama de trabajo

3. Hacer checkout de una etiqueta y crear una rama (Recomendado)

Si desea realizar cambios basados en una etiqueta, cree una nueva rama a partir de ella:

git checkout -b my-feature-branch <tag-name>

O usando el nuevo comando git switch:

git switch -c my-feature-branch <tag-name>

4. Hacer checkout de una etiqueta remota

Para hacer checkout de una etiqueta de un repositorio remoto:

1. Obtenga todas las etiquetas:

   git fetch --tags
   

2. Haga checkout de la etiqueta:

   git checkout tags/<tag-name>
   

5. Volver a una rama

Si está en un estado HEAD desconectado y desea regresar:

git checkout main  # O cualquier nombre de rama

O con git switch:

git switch main

Preguntas frecuentes

Conclusión

Hacer checkout de una etiqueta de Git es útil para ver una instantánea de su repositorio en un punto específico. Sin embargo, dado que las etiquetas no son ramas, debe crear una nueva rama si necesita realizar cambios.