fatal: 'v1 0' is not a valid tag name.
Numele tagului conține un caracter interzis, de obicei un spațiu, ~, ^, :, ? sau două puncte la rând. Folosește un nume simplu, fără spații, de exemplu git tag v1.0 sau git tag v1.0.0.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Tagurile și branch-urile sunt referințe, iar numele lor trebuie să respecte aceleași reguli: fără spații, fără caracterele ~ ^ : ? * [ \, fără .., să nu înceapă sau să se termine cu / sau . și să nu se termine cu .lock. Dacă numele încalcă vreo regulă, Git refuză: fatal: 'v1 0' is not a valid tag name., cu numele exact între ghilimele.
Cel mai des e un spațiu (git tag "versiunea 1"), o virgulă zecimală scrisă cu spațiu, două puncte (release:2026) sau un nume copiat dintr-un document, cu ghilimele tipografice. Convenția folosită aproape peste tot e versionarea semantică cu prefixul v: v1.0.0, v2.3.1. Mesajul, descrierea lungă și data le pui într-un tag adnotat, cu -m.
De ce apare: cauzele frecvente
1Spațiu în nume
git tag "v1 0"git tag v1.0Spațiul nu e permis în numele referințelor; punctul este.
2Descrierea pusă în nume
git tag "Lansare martie"git tag -a v1.1 -m "Lansare martie"Numele rămâne scurt, iar textul liber merge în mesajul tagului adnotat.
3Caractere speciale
git tag release:2026
git tag v2..0git tag release-2026
git tag v2.0: și .. au sens special în Git (refspec, intervale), deci sunt interzise în nume.
Repară eroarea, direct în pagină
Vrei să marchezi versiunea lansată și s-o publici pe GitHub, dar git tag "v1 0" dă fatal: 'v1 0' is not a valid tag name.. Pune pe ultimul commit tagul v1.0 și urcă tagul pe remote-ul origin.
Indiciu
Înlocuiește spațiul cu un caracter permis; tagurile se urcă explicit cu git push.
Reparația
Vezi eroarea:
git tag "v1 0"Creează tagul corect și urcă-l:
git tag v1.0
git push origin v1.0
git log --oneline --decorate -1Rezultat: ultimul commit are tagul v1.0, iar tagul e pe GitHub.
De ce merge
Spațiul nu e permis în numele referințelor, așa că Git a refuzat tagul. v1.0 respectă regulile și urmează convenția obișnuită pentru versiuni. Tagurile nu se urcă la un git push simplu, de aceea git push origin v1.0 îl trimite explicit pe server.
Alte forme ale mesajului
fatal: 'Lansare martie' is not a valid tag name.fatal: 'release:2026' is not a valid tag name.
Cum o eviți pe viitor
- Folosește formatul
vMAJOR.MINOR.PATCH(v1.0.0) pentru toate versiunile. - Pune textul descriptiv în mesajul unui tag adnotat (
git tag -a v1.0 -m "..."), nu în nume. - Poți verifica un nume înainte cu
git check-ref-format "refs/tags/v1.0" && echo valid. - În scripturile de lansare, construiește numele tagului din numărul versiunii, nu din text liber.
Întrebări frecvente
Ce caractere sunt permise?
Litere, cifre, ., -, _ și / (ca separator, de exemplu release/v1.0). Reguli complete: git help check-ref-format.
Am același mesaj și pentru branch-uri?
Da, la git branch sau git switch -c mesajul e fatal: 'nume' is not a valid branch name. Regulile sunt aceleași.
Erori înrudite
fatal: 'feature login' is not a valid branch name Numele de branch conține caractere pe care Git nu le acceptă (spații, două puncte la rând, ~ ^ : ? * [ sau \). Folosește cratimă sau slash: git switch -c feature-login sau feature/login. 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). 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. Î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.
