...
Eroare Git · Push, remote și GitHub

error: src refspec main matches more than one

Pe scurt

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

Greșit
BASH
git tag main
git push origin main
Corect
BASH
git tag -d main
git push origin main

Fără tag, main înseamnă doar branch-ul, iar push-ul știe ce să trimită.

2Trebuie să urci acum, fără să atingi tagul

Greșit
BASH
git push origin develop
Corect
BASH
git push origin refs/heads/develop:refs/heads/develop

Numele complete ale referințelor elimină ambiguitatea.

3Tagul greșit a ajuns și pe server

Greșit
BASH
git tag -d main   # pe server rămâne
Corect
BASH
git 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ă tu

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.

Alte forme ale mesajului

  • error: src refspec develop matches more than one
  • error: 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 avertismentul refname 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

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