git tag în Git

git tag [opțiuni] [nume_etichetă] [commit]

Ce face git tag

Etichetele (tags) sunt folosite pentru a marca versiuni oficiale de lansare ale aplicației (cum ar fi v1.0.0 sau v2.4.1). Spre deosebire de o ramură (care se mișcă automat înainte la fiecare nou commit), o etichetă rămâne fixată pentru totdeauna pe acel commit specific.

Git suportă două tipuri de etichete: etichete simple (lightweight, un simplu pointer) și etichete adnotate (annotated, create cu -a), care conțin autorul, data, un mesaj descriptiv și pot fi semnate criptografic cu GPG.

Opțiuni și argumente

Opțiune / Parametru	Descriere
-a NUME -m MESAJ	Creează o etichetă adnotată (recomandat pentru lansări oficiale de versiuni).
-l, --list	Listează toate etichetele existente în proiect (suportă și măști, ex. -l "v1.*").
-d NUME	Șterge o etichetă locală.
-s	Semnează eticheta criptografic cu cheia privată GPG a autorului.

Exemple

Exemplul 1: Crearea unei etichete de versiune adnotate

Marcăm versiunea v1.0.0 a proiectului.

git init -b main demo_tag >/dev/null
cd demo_tag
git config user.name "Test" && git config user.email "test@exemplu.ro"
touch app && git add app && git commit -m "Lansare v1" >/dev/null
git tag -a v1.0.0 -m "Prima versiune stabila oficiala"
git tag

Rezultat

v1.0.0

Greșeli frecvente

• Presupunerea că git push trimite automat și etichetele pe GitHub: în mod implicit, Git NU include etichetele la un simplu push. Pentru a publica etichetele pe server, trebuie să rulezi git push origin v1.0.0 sau git push origin --tags.

Comenzi înrudite

• git show: Afișează informații detaliate și diferențele de cod (diff) ale unui commit, etichetă sau fișier istoric.
• git push: Încarcă commit-urile locale pe serverul de la distanță (remote) pentru a fi partajate cu echipa.
• git checkout: Comandă multifuncțională clasică pentru comutarea ramurilor sau restaurarea fișierelor din istoric.