error: src refspec main matches more than one
La push, numele main se potrivește cu mai multe referințe locale (de obicei branch-ul main și un tag main), iar Git nu știe pe care s-o trimită. Șterge tagul greșit cu git tag -d main sau scrie numele complet: git push origin refs/heads/main.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În git push origin main, main e partea „sursă” a unui refspec: Git caută local ce înseamnă main. Dacă găsește și refs/heads/main (branch-ul), și refs/tags/main (un tag cu același nume), nu poate decide ce să trimită și se oprește: error: src refspec main matches more than one, urmat de error: failed to push some refs.
Cauza obișnuită e un tag creat din greșeală cu numele unui branch (git tag main, git tag develop) sau un script care creează taguri după numele branch-urilor. Același conflict de nume îți dă la alte comenzi avertismentul warning: refname 'main' is ambiguous.. Verifici cu git tag -l și git show-ref main, apoi ștergi tagul (și de pe remote, dacă a ajuns acolo).
De ce apare: cauzele frecvente
1Tag cu același nume ca branch-ul
git tag main
git push origin maingit tag -d main
git push origin mainFără tag, main înseamnă doar branch-ul, iar push-ul știe ce să trimită.
2Trebuie să urci acum, fără să atingi tagul
git push origin developgit push origin refs/heads/develop:refs/heads/developNumele complete ale referințelor elimină ambiguitatea.
3Tagul greșit a ajuns și pe server
git tag -d main # pe server rămânegit tag -d main
git push origin --delete refs/tags/mainȘtergi tagul și local, și de pe remote, ca să nu-l primească înapoi colegii la fetch.
Repară eroarea, direct în pagină
Ai creat din greșeală un tag numit main, iar acum git push origin main dă error: src refspec main matches more than one. Șterge tagul main (branch-ul rămâne) și urcă pe GitHub ultimul commit de pe branch-ul main.
Indiciu
Uită-te în lista tagurilor; un nume de acolo se potrivește cu numele branch-ului.
Reparația
Vezi eroarea și referințele:
git push origin main
git tag -lȘterge tagul și urcă branch-ul:
git tag -d main
git push origin mainRezultat: main de pe GitHub are ultimul tău commit.
De ce merge
Git găsea local două referințe numite main: branch-ul și tagul, așa că nu știa ce să trimită. După git tag -d main, numele e din nou unic, iar git push origin main urcă branch-ul. Commit-urile nu au fost afectate, pentru că tagul era doar o etichetă.
Alte forme ale mesajului
error: src refspec develop matches more than oneerror: failed to push some refs to 'https://github.com/elev/magazin.git'error: dst refspec main matches more than one
Cum o eviți pe viitor
- Denumește tagurile după versiuni (
v1.0), niciodată după branch-uri. - Verifică din când în când
git tag -l, mai ales dacă vezi avertismentulrefname is ambiguous. - În scripturile de CI, folosește nume complete (
refs/heads/...,refs/tags/...) când faci push.
Întrebări frecvente
Cum văd ce referințe se potrivesc cu main?
git show-ref main listează toate: de exemplu refs/heads/main, refs/remotes/origin/main și refs/tags/main. Dacă vezi un tag, el e cauza.
Pierd ceva dacă șterg tagul?
Nu pierzi commit-uri: tagul e doar o etichetă. Dacă tagul marca o versiune importantă, pune pe același commit un tag cu nume corect înainte să-l ștergi.
Erori înrudite
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. error: src refspec main does not match any Încerci să urci branch-ul main, dar local nu există niciun branch cu acest nume: de obicei nu ai făcut încă niciun commit sau branch-ul tău se numește master. Fă primul commit (git add, git commit) sau urcă branch-ul cu numele lui real. hint: Updates were rejected because the tag already exists in the remote. Pe server există deja un tag cu același nume, pus pe alt commit, iar Git nu suprascrie tag-uri publicate. Nu muta o versiune lansată: creează un tag nou (de exemplu v1.0.1) și urcă-l cu git push origin v1.0.1. Î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.
