fatal: No names found, cannot describe anything.
git describe caută cel mai apropiat tag adnotat ca să numească versiunea, iar repository-ul nu are niciunul. Creează un tag adnotat (git tag -a v1.0 -m "..."), fă fetch la taguri dacă sunt pe server sau folosește git describe --tags --always.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
git describe dă un nume ușor de citit commit-ului curent, pornind de la cel mai apropiat tag: v1.0 dacă ești chiar pe tag, v1.0-3-g4f2a1b9 dacă ești la 3 commit-uri după el. Implicit folosește doar tagurile adnotate. Dacă nu găsește niciun tag, afișează fatal: No names found, cannot describe anything.; dacă există doar taguri simple, mesajul e No annotated tags can describe '...' cu sfatul try --tags.
Eroarea apare des în scripturile de build și în CI, care calculează versiunea cu git describe: proiectul nu are încă taguri, tagurile sunt simple sau clona din CI e superficială (--depth 1) și nu a adus tagurile. Reparația ține de cauză: creezi un tag adnotat, aduci tagurile cu git fetch --tags sau faci scriptul tolerant cu --tags --always, care cade pe hash-ul scurt.
De ce apare: cauzele frecvente
1Proiectul nu are taguri
git describegit tag -a v0.1.0 -m "Prima versiune"
git describeCu un tag adnotat, describe are de la ce să pornească.
2Clona din CI nu are tagurile
git clone --depth 1 https://github.com/elev/app.git
git describegit fetch --tags --unshallow
git describeClona superficială nu are nici istoricul, nici tagurile necesare.
3Script care nu trebuie să cadă
VERSIUNE=$(git describe)VERSIUNE=$(git describe --tags --always)--tags acceptă și taguri simple, iar --always folosește hash-ul scurt dacă nu există niciun tag.
Repară eroarea, direct în pagină
Scriptul de build calculează versiunea cu git describe și cade cu No names found, cannot describe anything., pentru că proiectul nu are niciun tag. Prima lansare a fost commit-ul Lansare 1.0 (penultimul). Pune pe el tagul adnotat v1.0, cu mesajul Versiunea 1.0.
Indiciu
Tagul nu e pe ultimul commit, ci pe cel de dinaintea lui.
Reparația
Vezi istoricul:
git log --onelinePune tagul adnotat pe penultimul commit:
git tag -a v1.0 -m "Versiunea 1.0" HEAD~1
git log --oneline --decorateRezultat: Lansare 1.0 are tagul v1.0. Pe un calculator real, git describe afișează acum v1.0-1-g urmat de hash.
De ce merge
git describe caută cel mai apropiat tag adnotat, iar proiectul nu avea niciunul. Cu git tag -a v1.0 -m "Versiunea 1.0" HEAD~1, commit-ul Lansare 1.0 primește un tag adnotat, iar git describe pe ultimul commit va da v1.0-1-g..., adică un commit după versiunea 1.0.
Alte forme ale mesajului
fatal: No annotated tags can describe '4f2a1b9c0d...'. However, there were unannotated tags: try --tags.fatal: No tags can describe '4f2a1b9c0d...'. Try --always, or create some tags.
Cum o eviți pe viitor
- Pune un tag adnotat la fiecare lansare:
git tag -a v1.2.0 -m "..."și urcă-l cugit push origin v1.2.0. - În CI, configurează checkout-ul cu istoric complet și taguri (de exemplu
fetch-depth: 0). - În scripturi, folosește
git describe --tags --always, ca build-ul să nu cadă dacă lipsesc tagurile.
Întrebări frecvente
Ce înseamnă v1.0-3-g4f2a1b9?
Ești la 3 commit-uri după tagul v1.0, pe commit-ul cu hash-ul scurt 4f2a1b9 (litera g vine de la git).
De ce tagurile simple nu sunt luate implicit?
Pentru că sunt considerate etichete personale sau temporare. Lansările oficiale se marchează cu taguri adnotate, care au autor, dată și mesaj.
Erori înrudite
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. 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. fatal: no tag message? Ai creat un tag adnotat (git tag -a) și ai închis editorul fără să scrii mesajul, așa că Git a renunțat. Dă mesajul direct în comandă: git tag -a v2.0 -m "Versiunea 2.0". Î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.
