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

fatal: ambiguous argument 'main': both revision and filename

Pe scurt

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

Greșit
BASH
go build -o main
git log main
Corect
BASH
git log main --
echo "/main" >> .gitignore

-- arată că main e revizie, iar .gitignore ține binarul în afara repository-ului.

2Voiai istoricul fișierului

Greșit
BASH
git log test
Corect
BASH
git log -- test

După --, test e tratat doar ca fișier.

3Fișier comis cu nume de branch

Greșit
BASH
git diff main feature
Corect
BASH
git 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ă tu

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.

Alte forme ale mesajului

  • fatal: ambiguous argument 'develop': both revision and filename
  • Use '--' 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 și git 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

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