fatal: tag 'v1.0' already exists
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
git tag v1.0
git commit -am "Reparație"
git tag v1.0git 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
git tag -f v1.0
git push --force origin v1.0git tag v1.0.1
git push origin v1.0.1O 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
git tag v1.0git tag -l
git show v1.0git tag fără nume (sau cu -l) listează tag-urile; cu un nume, încearcă să creeze unul.
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.
Reparația
Vezi eroarea și unde e tag-ul acum:
git tag v1.0
git log --oneline --decorateMută tag-ul pe commit-ul curent:
git tag -f v1.0
git log --oneline --decorateRezultat: tag: v1.0 apare lângă commit-ul Reparație de ultim moment.
De ce merge
Numele v1.0 era deja folosit pentru commit-ul anterior, iar Git nu-l mută fără să-i ceri explicit. git tag -f v1.0 îl mută pe commit-ul curent (Git afișează Updated tag 'v1.0'). E o operație sigură aici, pentru că tag-ul exista doar local. Dacă ar fi fost deja pe GitHub, varianta corectă ar fi fost o versiune nouă.
Alte forme ale mesajului
fatal: tag 'v1.0.0' already existsUpdated 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
hint: Updates were rejected because the tag already exists in the remote. Pe server există deja un tag cu același nume, pus pe alt commit, iar Git nu suprascrie tag-uri publicate. Nu muta o versiune lansată: creează un tag nou (de exemplu v1.0.1) și urcă-l cu git push origin v1.0.1. fatal: a branch named 'feature/login' already exists Încerci să creezi un branch cu un nume care există deja. Dacă vrei să lucrezi pe el, treci pe el cu git switch feature/login (fără -c); dacă vrei unul nou, alege alt nume. fatal: ambiguous argument 'HEAD~3': unknown revision or path not in the working tree. Git nu înțelege argumentul dat: nu e un commit, branch sau tag existent și nici un fișier din proiect. Verifică dacă istoria are destule commit-uri (HEAD~3 cere cel puțin 4), dacă numele branch-ului e corect și, pentru fișiere, pune -- înaintea lor. Î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.
