Zum Inhalt

git tag

Gibt einem Commit einen festen Namen, meist eine Versionsnummer wie v1.0.

git-tag output

Syntax

git tag [-a NAME [-m "NACHRICHT"] [COMMIT]]

Optionen

Option Beschreibung
(keine) Alle Tags auflisten
-a NAME Einen annotierten Tag mit Autor, Datum und Nachricht anlegen
-m NACHRICHT Nachricht des Tags
COMMIT Diesen Commit taggen statt des aktuellen
-l MUSTER Nur Tags auflisten, die zum Muster passen, etwa "v1.*"
-n Auch die Nachricht jedes Tags zeigen
-d NAME Einen lokalen Tag löschen

Beispiele

Den aktuellen Stand als neue Version taggen:

git tag -a v1.1 -m "Service check added"
git tag -n
v1.0            First stable version
v1.1            Service check added

Einen älteren Commit taggen:

git tag -a v0.9 0487470 -m "First scripts"
git tag -l "v0*"
v0.9

Anzeigen, worauf ein Tag zeigt:

git show --no-patch v1.0
tag v1.0
Tagger: Nox <nox@example.com>
Date:   Thu Oct 22 11:05:13 2026 +0200

First stable version

commit 3fcc96a03d03b18b18a33eaf4ad512124ab1d11e (tag: v1.0)
Author: Nox <nox@example.com>
Date:   Thu Oct 22 11:05:13 2026 +0200

    Also check /mnt/backup

Einen Tag auf den Server schicken:

git push origin v1.1
Enumerating objects: 1, done.
Counting objects: 100% (1/1), done.
Writing objects: 100% (1/1), 172 bytes | 172.00 KiB/s, done.
Total 1 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)
To git.example.com:nox/scripts.git
 * [new tag]         v1.1 -> v1.1

Wann brauche ich das?

  • Um den Stand zu markieren, der in Produktion läuft, damit du ihn jederzeit wiederfindest
  • Um Skripten oder Rollen Versionsnummern zu geben, auf die sich andere beziehen können
  • Um nach einer missglückten Änderung schnell zu einem bekannten guten Stand zurückzukehren

git push schickt keine Tags

Ein einfaches git push überträgt nur Branches. Push einen Tag mit git push origin v1.1 oder alle annotierten Tags zusammen mit den Commits per git push --follow-tags.

Verwandte Befehle

git log · git push · git switch · git diff