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

fatal: No names found, cannot describe anything.

Pe scurt

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

Greșit
BASH
git describe
Corect
BASH
git tag -a v0.1.0 -m "Prima versiune"
git describe

Cu un tag adnotat, describe are de la ce să pornească.

2Clona din CI nu are tagurile

Greșit
BASH
git clone --depth 1 https://github.com/elev/app.git
git describe
Corect
BASH
git fetch --tags --unshallow
git describe

Clona superficială nu are nici istoricul, nici tagurile necesare.

3Script care nu trebuie să cadă

Greșit
BASH
VERSIUNE=$(git describe)
Corect
BASH
VERSIUNE=$(git describe --tags --always)

--tags acceptă și taguri simple, iar --always folosește hash-ul scurt dacă nu există niciun tag.

Repară tu

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.

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 cu git 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

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