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

fatal: Failed to resolve 'HEAD' as a valid ref.

Pe scurt

Î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

Greșit
BASH
git init
git tag v0.1
Corect
BASH
git init
git add .
git commit -m "Prima versiune"
git tag v0.1

Tagul are nevoie de un commit. După primul commit, HEAD e valid.

2Hash-ul dat nu există

Greșit
BASH
git tag v1.0 abc1234
Corect
BASH
git log --oneline
git tag v1.0 3f2a1b4

Git caută commit-ul după hash. Copiază-l exact din istoric.

Repară tu

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.

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 -1 că 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

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