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

fatal: 'v1 0' is not a valid tag name.

Pe scurt

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

Greșit
BASH
git tag "v1 0"
Corect
BASH
git tag v1.0

Spațiul nu e permis în numele referințelor; punctul este.

2Descrierea pusă în nume

Greșit
BASH
git tag "Lansare martie"
Corect
BASH
git tag -a v1.1 -m "Lansare martie"

Numele rămâne scurt, iar textul liber merge în mesajul tagului adnotat.

3Caractere speciale

Greșit
BASH
git tag release:2026
git tag v2..0
Corect
BASH
git tag release-2026
git tag v2.0

: și .. au sens special în Git (refspec, intervale), deci sunt interzise în nume.

Repară tu

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.

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

← 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.