Git Tag
Última actualización
git tag marca un commit específico con un nombre - normalmente una versión de lanzamiento como v1.0.0. Las etiquetas vienen en dos formas: ligeras (solo un nombre que apunta a un commit) y anotadas (un objeto completo con un mensaje, autor y fecha). Las etiquetas no se suben automáticamente, así que las subes por separado.
Prueba estos en el terminal playground - una shell real en tu navegador, sin nada que instalar.
Sintaxis
| Command | What it does |
|---|---|
git tag v1.0.0 | Crear una etiqueta ligera en HEAD |
git tag -a v1.0.0 -m "Release 1.0" | Crear una etiqueta anotada con un mensaje |
git tag -a v1.0.0 <hash> | Etiquetar un commit anterior específico |
git tag | Listar todas las etiquetas |
git push origin v1.0.0 | Subir una etiqueta al remoto |
git push --tags | Subir todas las etiquetas |
git tag -d v1.0.0 | Eliminar una etiqueta local |
lightweight vs annotated
| Lightweight | Annotated | |
|---|---|---|
| Almacena un mensaje | No | Sí |
| Registra autor y fecha | No | Sí |
| Buena para lanzamientos | No | Sí |
Preguntas frecuentes sobre git tag
¿Cómo creo una etiqueta en Git?
Para un marcador rápido, ejecuta
git tag <name> (una etiqueta ligera en el commit actual). Para un lanzamiento, crea una etiqueta anotada: git tag -a v1.0.0 -m "Release 1.0", que almacena un mensaje, autor y fecha. Añade un hash de commit al final para etiquetar un commit más antiguo.¿Cuál es la diferencia entre etiquetas ligeras y anotadas?
Una etiqueta ligera es solo un nombre que apunta a un commit - sin datos adicionales. Una etiqueta anotada es un objeto completo de Git con un mensaje, nombre del autor y fecha, y se puede verificar. Usa etiquetas anotadas para lanzamientos; las ligeras están bien para marcadores temporales o privados.
¿Cómo subo etiquetas al remoto?
Las etiquetas no se incluyen en un
git push normal. Sube una etiqueta específica con git push origin <tagname>, o sube todas las etiquetas a la vez con git push --tags. Esto confunde a la gente - una etiqueta que creaste permanece local hasta que la subes.¿Cómo elimino una etiqueta?
Elimina una etiqueta local con
git tag -d <tagname>. Para eliminarla también del remoto, ejecuta git push origin --delete <tagname> (o el antiguo git push origin :refs/tags/<tagname>). Las eliminaciones de etiquetas locales y remotas son pasos separados.¿Puedo practicar esto en línea?
Sí. Abre el terminal playground para ejecutar
git tag en una shell real en tu navegador - sin nada que instalar. El curso interactivo y gratuito de Git de Coddy también cubre el etiquetado y los lanzamientos paso a paso.