fatal: Failed to resolve 'HEAD' as a valid ref.
Încerci să creezi un tag (sau un branch) într-un repository fără niciun commit, așa că HEAD nu arată spre nimic. Fă întâi primul commit, apoi git tag v0.1. Dacă ai dat explicit un commit, verifică hash-ul cu git log --oneline.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un tag e o etichetă pusă pe un commit. git tag v0.1 fără alt argument pune eticheta pe HEAD, adică pe commit-ul curent. Într-un repository nou, creat cu git init, fără niciun commit, HEAD arată spre un branch care încă nu există, deci nu are ce eticheta: fatal: Failed to resolve 'HEAD' as a valid ref.
Același mesaj, cu alt nume, apare când îi dai lui git tag un commit sau un branch care nu există: fatal: Failed to resolve 'abc123' as a valid ref. (hash greșit, scurtat prea mult sau dintr-un alt repository). Reparația e să ai un commit valid: fă primul commit, sau copiază hash-ul exact din git log --oneline.
De ce apare: cauzele frecvente
1Tag într-un repository fără commit-uri
git init
git tag v0.1git init
git add .
git commit -m "Prima versiune"
git tag v0.1Tagul are nevoie de un commit. După primul commit, HEAD e valid.
2Hash-ul dat nu există
git tag v1.0 abc1234git log --oneline
git tag v1.0 3f2a1b4Git caută commit-ul după hash. Copiază-l exact din istoric.
Repară eroarea, direct în pagină
Ai creat proiectul nou și vrei să marchezi prima versiune. git tag v0.1 dă fatal: Failed to resolve 'HEAD' as a valid ref.. Salvează app.js în primul commit, cu mesajul Prima versiune, și pune pe el tagul v0.1.
Indiciu
Un tag are nevoie de un commit pe care să stea.
Reparația
Vezi eroarea:
git tag v0.1Fă primul commit, apoi tagul:
git add app.js
git commit -m "Prima versiune"
git tag v0.1
git log --oneline --decorateRezultat: commit-ul Prima versiune are tagul v0.1.
De ce merge
Repository-ul nu avea niciun commit, deci HEAD nu arăta spre nimic și Git nu avea ce eticheta. După primul commit, HEAD e commit-ul Prima versiune, iar git tag v0.1 pune eticheta pe el. Cu git tag -a v0.1 -m "mesaj" ai fi obținut un tag adnotat, recomandat pentru versiunile lansate.
Alte forme ale mesajului
fatal: Failed to resolve 'abc1234' as a valid ref.fatal: Failed to resolve 'main' as a valid ref.
Cum o eviți pe viitor
- Pune tagurile doar după ce versiunea e într-un commit.
- Copiază hash-urile din
git log --oneline, nu le tasta din memorie. - Verifică cu
git log --oneline -1că ai cel puțin un commit înainte de a crea taguri sau branch-uri.
Întrebări frecvente
De ce git branch dă alt mesaj în aceeași situație?
git branch nou într-un repository gol dă fatal: not a valid object name: 'main'. Cauza e aceeași: nu există încă un commit pe care să arate noul branch.
Ce diferență e între un tag simplu și unul adnotat?
Un tag simplu (git tag v1.0) e doar un nume pentru un commit. Unul adnotat (git tag -a v1.0 -m "Lansare") are și autor, dată și mesaj, de aceea e recomandat pentru versiunile lansate.
Erori înrudite
fatal: your current branch 'main' does not have any commits yet Repository-ul există, dar pe branch-ul curent nu e încă niciun commit, deci git log nu are ce afișa. Fă primul commit (git add, apoi git commit -m "...") și comanda va merge. fatal: not a valid object name: 'main' Încerci să creezi un branch într-un repository fără niciun commit, iar noul branch nu are de unde să pornească. Fă întâi primul commit pe main, apoi git branch nume (sau git switch -c nume). error: tag 'v2.0' not found. Tagul pe care vrei să-l ștergi (git tag -d) nu există local cu acel nume. Listează tagurile cu git tag -l, copiază numele exact (de exemplu v2.0.0) și reia comanda; dacă tagul e doar pe server, rulează întâi git fetch --tags. Î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.
