fatal: ambiguous argument 'main': both revision and filename
Numele dat (aici main) este și un branch, și un fișier din folder, iar Git nu știe dacă vrei istoricul branch-ului sau al fișierului. Separă cu --: git log main -- pentru branch, git log -- main pentru fișier; pe termen lung, redenumește fișierul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Comenzi ca git log, git diff sau git checkout primesc și revizii (branch-uri, taguri, commit-uri), și căi (fișiere). Când un argument se potrivește cu ambele, de exemplu există și branch-ul main, și un fișier numit main, Git nu ghicește: fatal: ambiguous argument 'main': both revision and filename, urmat de sfatul Use '--' to separate paths from revisions.
Tot ce e înainte de -- e revizie, tot ce e după e cale. Deci git log main -- înseamnă istoricul branch-ului, iar git log -- main înseamnă istoricul fișierului. Fișiere cu nume de branch apar mai des decât crezi: main (binarul compilat dintr-un main.go sau main.c), develop, test, master. Dacă fișierul e un build, scoate-l din repository și pune-l în .gitignore.
De ce apare: cauzele frecvente
1Binar compilat cu numele branch-ului
go build -o main
git log maingit log main --
echo "/main" >> .gitignore-- arată că main e revizie, iar .gitignore ține binarul în afara repository-ului.
2Voiai istoricul fișierului
git log testgit log -- testDupă --, test e tratat doar ca fișier.
3Fișier comis cu nume de branch
git diff main featuregit mv main main-notite.md
git commit -m "Redenumesc main"Fără un fișier cu același nume, ambiguitatea dispare din toate comenzile.
Repară eroarea, direct în pagină
În proiect există fișierul main cu notițe, comis din greșeală cu acest nume, iar git log main dă ambiguous argument 'main': both revision and filename. Redenumește fișierul în notite.md, păstrându-i istoricul, și comite cu mesajul Redenumesc notițele.
Indiciu
Redenumirea unui fișier urmărit se face cu o comandă Git, ca să intre direct în staging.
Reparația
Vezi eroarea:
git log mainRedenumește fișierul și salvează:
git mv main notite.md
git commit -m "Redenumesc notițele"
git log --oneline mainRezultat: git log main arată istoricul branch-ului.
De ce merge
Git găsea main și ca branch, și ca fișier, așa că nu știa ce voiai. După git mv main notite.md și commit, numele main înseamnă doar branch-ul, iar git log main merge fără --. Fișierul își păstrează istoricul, pe care îl vezi cu git log --follow -- notite.md.
Alte forme ale mesajului
fatal: ambiguous argument 'develop': both revision and filenameUse '--' to separate paths from revisions, like this: 'git <command> [<revision>...] -- [<file>...]'
Cum o eviți pe viitor
- Nu da fișierelor nume de branch-uri (
main,develop,test). - Pune binarele compilate și alte fișiere generate în
.gitignore. - În scripturi, scrie mereu
--între revizii și căi:git log "$BRANCH" --. - Când vezi eroarea, rulează
lsșigit branch: numele care apare în ambele liste e cauza.
Întrebări frecvente
De ce mergea comanda înainte?
Pentru că fișierul nu exista. Git verifică folderul la fiecare comandă, deci eroarea apare din momentul în care creezi (de exemplu prin build) un fișier cu numele unui branch.
Ce înseamnă „unknown revision or path not in the working tree”?
E situația opusă: numele nu e nici revizie, nici fișier. Acolo verifici numele branch-ului sau al commit-ului.
Erori înrudite
fatal: ambiguous argument 'HEAD~3': unknown revision or path not in the working tree. 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. warning: refname 'main' is ambiguous. Același nume, de obicei main, există și ca branch, și ca tag, iar Git nu știe sigur la care te referi (alege tagul). Șterge sau redenumește tagul (git tag -d main) și folosește pentru versiuni nume ca v1.0. fatal: path 'config.json' does not exist in 'HEAD' Fișierul nu există la calea dată în commit-ul respectiv. În sintaxa HEAD:cale, calea pornește de la rădăcina repository-ului, nu din folderul curent: scrie git show HEAD:src/config.json (sau HEAD:./config.json din folderul src). Î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.
