Conceptos clave

Etiqueta

En Git, una etiqueta es una referencia a un punto concreto del historial del repositorio. Las etiquetas se usan para marcar hitos importantes o versiones publicadas en el ciclo de vida del proyecto. A diferencia de las ramas, las etiquetas son estáticas y no cambian después de crearse.

Las etiquetas se usan normalmente para:

  1. Marcar versiones publicadas: Cuando una versión nueva del software está lista para publicarse, se crea una etiqueta para marcar ese punto concreto en el historial de commits. Por ejemplo, al publicar la versión 2.3.1 de un proyecto, se puede crear una etiqueta llamada v2.3.1 para referenciar el commit que representa esa versión publicada. Esos números de versión suelen seguir convenciones de versionado semántico.

    El prefijo v no es obligatorio, pero se usa a menudo para indicar que la etiqueta representa un número de versión. Esto permite que ramas llamadas X.Y.Z coexistan con etiquetas llamadas vX.Y.Z.
  2. Marcar hitos importantes: Las etiquetas también pueden usarse para marcar hitos significativos en el desarrollo del proyecto, como completar una funcionalidad grande o corregir un bug crítico. Por ejemplo, se puede crear una etiqueta llamada feature-x-completion para marcar el commit que introduce una funcionalidad nueva.

  3. Referencia rápida: Las etiquetas ofrecen una forma cómoda de referenciar un punto concreto del historial del repositorio sin tener que recordar o buscar el hash del commit. Esto es especialmente útil cuando necesitas cambiar rápidamente entre distintas versiones del proyecto.

Ejemplos

Crea una etiqueta simple:

git tag v1.0.0

Crea una etiqueta anotada con un mensaje:

git tag -a v1.2.0 -m "Release 1.2.0"

Lista todas las etiquetas:

git tag

Cambia a una etiqueta concreta:

git checkout v1.2.0

Compara cambios entre una etiqueta y el HEAD actual:

git diff v1.2.0..HEAD