...
Eroare Git · Istoric, reset și revert

fatal: tag 'v1.0' already exists

Pe scurt

Există deja un tag cu acest nume în repository. Dacă vrei să-l muți pe alt commit și nu l-ai urcat încă, folosește git tag -f v1.0; dacă e deja publicat, creează o versiune nouă (v1.0.1).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un tag este un nume fix pentru un commit, iar git tag v1.0 creează unul nou. Dacă numele e deja folosit, Git refuză, ca să nu-ți mute din greșeală o versiune existentă. Vezi pe ce commit e tag-ul cu git show v1.0 sau git log --oneline --decorate.

Ce faci depinde de situație. Dacă tag-ul e doar local și l-ai pus prea devreme (de exemplu înainte de o reparație de ultim moment), îl muți cu git tag -f v1.0 (sau git tag -d v1.0 și apoi îl creezi din nou). Dacă tag-ul a fost deja urcat și folosit, nu-l muta: creezi o versiune nouă, de exemplu v1.0.1. Tag-urile se trimit pe server separat, cu git push origin v1.0.

De ce apare: cauzele frecvente

1Ai pus tag-ul înainte de o reparație

Greșit
BASH
git tag v1.0
git commit -am "Reparație"
git tag v1.0
Corect
BASH
git tag -f v1.0

-f mută tag-ul existent pe commit-ul curent. E sigur doar cât timp tag-ul nu a fost urcat.

2Tag-ul e deja publicat

Greșit
BASH
git tag -f v1.0
git push --force origin v1.0
Corect
BASH
git tag v1.0.1
git push origin v1.0.1

O versiune publicată trebuie să rămână fixă; reparația primește un număr nou.

3Ai vrut să vezi tag-urile, nu să creezi unul

Greșit
BASH
git tag v1.0
Corect
BASH
git tag -l
git show v1.0

git tag fără nume (sau cu -l) listează tag-urile; cu un nume, încearcă să creeze unul.

Repară tu

Repară eroarea, direct în pagină

Ai pus tag-ul v1.0 pe commit-ul Versiunea 1.0, apoi ai mai făcut commit-ul Reparație de ultim moment. Tag-ul nu a fost urcat încă. git tag v1.0 pe noul commit dă fatal: tag 'v1.0' already exists. Mută v1.0 pe ultimul commit.

Indiciu

Tag-ul existent poate fi mutat cu o opțiune, sau șters și creat din nou.

Alte forme ale mesajului

  • fatal: tag 'v1.0.0' already exists
  • Updated tag 'v1.0' (was 3f2a1b4)

Cum o eviți pe viitor

  • Pune tag-ul după ce ai verificat ultimul commit al versiunii (teste, review).
  • Folosește versionare semantică: v1.0.0, v1.0.1, v1.1.0.
  • Verifică lista cu git tag -l înainte să creezi o versiune nouă.
  • Pentru versiunile lansate, folosește tag-uri adnotate (git tag -a v1.0 -m "Versiunea 1.0"), care păstrează autorul și data.

Întrebări frecvente

Ce face exact git tag -f?

Mută tag-ul existent pe commit-ul nou și afișează Updated tag 'v1.0' (was ...), cu vechiul hash. Local nu se pierde nimic: commit-ul vechi rămâne în istorie.

Dacă am urcat deja tag-ul?

Push-ul tag-ului mutat va fi respins (the tag already exists in the remote). Creează o versiune nouă sau, doar cu acordul echipei și dacă nimeni nu a folosit-o, forțează push-ul.

Erori înrudite

← Toate erorile Git

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Git de la zero, cu exerciții la fiecare lecție

Curs Git: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.