Come funzionano i tag e i rilasci in Git?

Question

Accepted Answer

**I tag** contrassegnano punti specifici nella cronologia come importanti — tipicamente **rilasci** (versioni come v1.0.0). A differenza dei branch, i tag sono puntatori fissi che non si muovono, utilizzati per etichettare e fare riferimento alle versioni di rilascio. Sono fondamentali per il versionamento e la gestione dei rilasci.

## Creazione di tag

```bash
# annotated tag (recommended for releases — has metadata: tagger, date, message)
git tag -a v1.0.0 -m "Release version 1.0.0"

# lightweight tag (just a pointer, no metadata)
git tag v1.0.0

# tag a specific past commit
git tag -a v1.0.0 <commit> -m "..."
```

**I tag annotati** (consigliati per i rilasci) memorizzano metadati (autore del tag, data, messaggio); **i tag lightweight** sono semplicemente un nome che punta a un commit.

## Lavoro con i tag

```bash
git tag                        # list tags
git show v1.0.0                # show a tag and its commit
git checkout v1.0.0            # check out the code at a tag (detached HEAD)

# tags are NOT pushed by default — push them explicitly:
git push origin v1.0.0         # push a specific tag
git push origin --tags         # push all tags
```

Importante: **i tag non vengono inviati automaticamente** con `git push` — devi inviarli esplicitamente.

## Tag vs branch

```text
BRANCH → a MOVABLE pointer that advances as you commit (ongoing development)
TAG    → a FIXED pointer to a specific commit (a permanent label — doesn't move)
→ Use tags to permanently mark releases/milestones; branches for ongoing work.
```

## Versionamento semantico e rilasci

```text
SEMANTIC VERSIONING (SemVer): MAJOR.MINOR.PATCH (e.g. v2.3.1)
  MAJOR → breaking changes | MINOR → new features (compatible) | PATCH → bug fixes
→ Tags label these versions. Platforms (GitHub) build "Releases" from tags
  (with release notes, built artifacts) for distribution.
```

## Perché è importante

Comprendere i tag e i rilasci è prezioso per il **versionamento e la gestione dei rilasci**, quindi è una conoscenza pratica utile per lavorare con il software rilasciato. **I tag** contrassegnano punti importanti nella cronologia — tipicamente **versioni di rilascio** (come v1.0.0) — fornendo riferimenti fissi e permanenti a commit specifici, che sono essenziali per tracciare e fare riferimento al codice che costituisce ogni rilascio.

Comprendere la distinzione tra **tag annotati** (consigliati per i rilasci, che memorizzano metadati come l'autore del tag, la data e il messaggio) e tag lightweight è una conoscenza pratica per un corretto tagging dei rilasci.

Sapere come creare, elencare e controllare tag, e soprattutto che **i tag non vengono inviati automaticamente** (richiedendo `git push origin --tags` esplicito o l'invio di tag specifici — un errore comune in cui le persone creano tag ma dimenticano di inviarli), è necessario per gestire correttamente i tag di rilascio.

Comprendere **tag vs branch** (un tag è un puntatore fisso a un commit specifico — un'etichetta permanente che non si muove — mentre un branch è un puntatore mobile che avanza con lo sviluppo) chiarisce i loro ruoli diversi: tag per contrassegnare permanentemente rilasci/milestone, branch per il lavoro in corso.

Comprendere la connessione al **versionamento semantico** (convenzioni MAJOR.MINOR.PATCH per comunicare la natura delle modifiche) e come le piattaforme costruiscono **Rilasci** dai tag (con note di rilascio e artefatti per la distribuzione) riflette come i tag si inseriscono nella reale gestione dei rilasci.

Poiché il rilascio e il versionamento del software è un'esigenza comune e i tag sono il meccanismo Git per contrassegnare e fare riferimento alle versioni di rilascio (centrale alla gestione dei rilasci e integrato con le funzioni di rilascio delle piattaforme), comprendere i tag e i rilasci — tag annotati vs lightweight, inviarli, tag vs branch, e il loro ruolo nel versionamento/rilasci — è una conoscenza Git preziosa e praticamente rilevante per gestire il software rilasciato, un aspetto utile dello sviluppo professionale collegato alle convenzioni di versionamento e ai processi di rilascio.