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

fatal: ambiguous argument 'HEAD~3': unknown revision or path not in the working tree.

Pe scurt

Git nu înțelege argumentul dat: nu e un commit, branch sau tag existent și nici un fișier din proiect. Verifică dacă istoria are destule commit-uri (HEAD~3 cere cel puțin 4), dacă numele branch-ului e corect și, pentru fișiere, pune -- înaintea lor.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Comenzi ca git log, git diff, git reset și git show primesc atât revizii (commit-uri, branch-uri, HEAD~2), cât și căi de fișiere. Git încearcă să interpreteze argumentul ca revizie; dacă nu reușește, verifică dacă e un fișier. Când nu e nici una, nici alta, afișează ambiguous argument și îți sugerează să folosești -- ca să separi reviziile de fișiere.

Cazuri tipice: HEAD~3 într-un repository cu doar 3 commit-uri (cel mai vechi este HEAD~2), un nume de branch greșit (mian), origin/main înainte de primul git fetch, sau HEAD într-un repository fără niciun commit. git log --oneline îți arată câte commit-uri ai și ce nume poți folosi. Pentru fișiere care nu mai există pe disc, scrie git log -- fișier.

De ce apare: cauzele frecvente

1Ai cerut mai multe commit-uri înapoi decât are istoria

Greșit
BASH
git log --oneline
# 3 commit-uri
git reset --soft HEAD~3
Corect
BASH
git reset --soft HEAD~2

HEAD~2 e deja primul commit. HEAD~3 ar fi părintele lui, care nu există.

2Numele branch-ului e scris greșit

Greșit
BASH
git diff mian
Corect
BASH
git diff main

Un nume care nu e branch, tag sau fișier dă această eroare. Folosește Tab sau git branch.

3Fișier șters, folosit fără --

Greșit
BASH
git log sters.txt
Corect
BASH
git log -- sters.txt

-- îi spune lui Git că ce urmează sunt căi, chiar dacă fișierul nu mai e pe disc.

Repară tu

Repară eroarea, direct în pagină

Articolul are trei commit-uri: titlu, introducere, concluzie. Vrei să unești ultimele două într-un singur commit, Articol complet, păstrând primul. Ai rulat git reset --soft HEAD~3 și ai primit fatal: ambiguous argument 'HEAD~3'. Fă unirea corect.

Indiciu

Numără commit-urile: primul este HEAD~2, iar tu vrei să rămâi pe el.

Alte forme ale mesajului

  • fatal: ambiguous argument 'HEAD': unknown revision or path not in the working tree.
  • fatal: ambiguous argument 'origin/main': unknown revision or path not in the working tree.
  • Use '--' to separate paths from revisions, like this: 'git <command> [<revision>...] -- [<file>...]'

Cum o eviți pe viitor

  • Rulează git log --oneline înainte de comenzi cu HEAD~N, ca să numeri commit-urile.
  • Folosește Tab pentru nume de branch-uri.
  • Pune -- înaintea fișierelor în git log, git diff și git checkout.
  • Rulează git fetch înainte să folosești origin/....

Întrebări frecvente

Ce înseamnă HEAD~1, HEAD~2?

HEAD~1 e părintele commit-ului curent, HEAD~2 e bunicul și așa mai departe. Într-un istoric de N commit-uri, cel mai vechi este HEAD~(N-1).

Cum desfac toate commit-urile, inclusiv primul?

Primul commit nu are părinte, deci nu poți face reset înaintea lui. Poți rescrie istoria de la zero cu git update-ref -d HEAD, care face ca toate fișierele să rămână în staging, gata pentru un commit nou.

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.