Como funcionam tags e releases no Git?

Question

Accepted Answer

**Tags** marcam pontos específicos no histórico como importantes — tipicamente **releases** (versões como v1.0.0). Ao contrário de branches, tags são ponteiros fixos que não se movem, usadas para etiquetar e referenciar versões de release. Elas são centrais para versionamento e gerenciamento de releases.

## Criando tags

```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 "..."
```

**Tags anotadas** (recomendadas para releases) armazenam metadados (quem criou, data, mensagem); **tags leves** são apenas um nome apontando para um commit.

## Trabalhando com tags

```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: **tags não são enviadas automaticamente** com `git push` — você as envia explicitamente.

## Tags vs branches

```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 semântico e releases

```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.
```

## Por que isso importa

Entender tags e releases é valioso para **versionamento e gerenciamento de releases**, então é conhecimento prático útil para trabalhar com software liberado. **Tags** marcam pontos importantes no histórico — tipicamente **versões de release** (como v1.0.0) — fornecendo referências fixas e permanentes a commits específicos, o que é essencial para rastrear e referenciar qual código constitui cada release.

Entender a distinção entre **tags anotadas** (recomendadas para releases, armazenando metadados como quem criou, data e mensagem) e tags leves é conhecimento prático para tagueamento apropriado de releases.

Saber como criar, listar e fazer checkout de tags, e importante, que **tags não são enviadas automaticamente** (exigindo `git push origin --tags` explícito ou envio de tags específicas — uma armadilha comum onde pessoas criam tags mas esquecem de enviá-las), é necessário para gerenciar corretamente tags de release.

Entender **tags vs branches** (uma tag é um ponteiro fixo para um commit específico — um rótulo permanente que não se move — enquanto um branch é um ponteiro móvel que avança com o desenvolvimento) esclarece seus papéis diferentes: tags para marcar permanentemente releases/marcos, branches para trabalho contínuo.

Entender a conexão com **versionamento semântico** (convenções MAJOR.MINOR.PATCH para comunicar a natureza das mudanças) e como plataformas criam **Releases** a partir de tags (com notas de release e artefatos para distribuição) reflete como tags se encaixam no gerenciamento real de releases.

Como lançar e versionar software é uma necessidade comum e tags são o mecanismo Git para marcar e referenciar versões de release (centrais ao gerenciamento de releases e integradas com recursos de releases das plataformas), entender tags e releases — tags anotadas vs leves, enviá-las, tags vs branches, e seu papel em versionamento/releases — é conhecimento Git valioso e praticamente relevante para gerenciar software lançado, um aspecto útil do desenvolvimento profissional conectado a convenções de versionamento e processos de release.