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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În git push origin main, main este refspec-ul sursă: numele branch-ului local pe care îl trimiți. Mesajul spune că sursa nu se potrivește cu nimic, deci local nu există branch-ul main, iar sub el vine error: failed to push some refs to ....
Cea mai frecventă cauză: repository nou, fără niciun commit. Un branch e o etichetă pe un commit; după git init, main există doar ca nume viitor și apare cu adevărat la primul commit. A doua cauză: branch-ul se numește master (setarea veche a lui Git), iar tutorialul de pe GitHub îți spune git push -u origin main. git branch îți arată numele real (sau nimic, dacă nu ai commit-uri), iar git status scrie No commits yet.
De ce apare: cauzele frecvente
1Nu ai făcut încă niciun commit
git init
git remote add origin https://github.com/elev/portofoliu.git
git push -u origin maingit add README.md
git commit -m "Primul commit"
git push -u origin mainPrimul commit creează efectiv branch-ul main. Abia apoi există ceva de urcat.
2Branch-ul tău se numește master
git branch
# * master
git push -u origin maingit branch -M main
git push -u origin maingit branch -M main redenumește branch-ul curent în main. Alternativ, urci cu numele lui: git push -u origin master.
3Ai scris greșit numele branch-ului
git push origin feature/Logingit push origin feature/loginNumele trebuie să fie exact cel din git branch, inclusiv literele mari.
Repară eroarea, direct în pagină
Ai creat repository-ul portofoliu pe GitHub, ai rulat local git init și git remote add origin, dar git push -u origin main dă error: src refspec main does not match any. Urcă proiectul (cu README.md) pe GitHub, astfel încât main să urmărească origin/main.
Indiciu
Un branch există abia după primul commit.
Reparația
Vezi eroarea și istoricul gol:
git push -u origin main
git loggit log spune că branch-ul main nu are încă niciun commit. Fă primul commit, apoi urcă:
git add README.md
git commit -m "Primul commit"
git push -u origin mainRezultat: Git afișează * [new branch] main -> main și branch 'main' set up to track 'origin/main'.
De ce merge
După git init, branch-ul main nu arăta încă spre niciun commit, deci nu exista nimic de trimis, iar refspec-ul sursă nu se potrivea cu nimic. Primul commit a creat branch-ul. git push -u origin main l-a urcat și, prin -u, a legat main de origin/main, așa că de acum ajung git push și git pull fără argumente.
Alte forme ale mesajului
error: src refspec master does not match anyerror: failed to push some refs to 'https://github.com/elev/portofoliu.git'
Cum o eviți pe viitor
- Fă primul commit înainte de primul push.
- Setează numele implicit al branch-ului principal:
git config --global init.defaultBranch main, ca să se potrivească cu GitHub. - Verifică numele cu
git branchînainte de push. - Pentru branch-ul curent poți scrie
git push -u origin HEAD, fără să tastezi numele.
Întrebări frecvente
Am făcut git add, dar tot apare eroarea. De ce?
git add doar pune fișierele în staging. Branch-ul apare la git commit.
De ce unele repository-uri au master și altele main?
Git folosea master ca nume implicit. GitHub a trecut la main în 2020, iar Git permite alegerea prin init.defaultBranch. Funcțional, sunt la fel.
Erori înrudite
fatal: 'origin' does not appear to be a git repository Repository-ul tău nu are niciun remote numit origin, deci Git tratează cuvântul ca pe o cale și nu găsește nimic acolo. Adaugă remote-ul cu git remote add origin URL (verifică cu git remote -v), apoi git push -u origin main. fatal: The current branch feature/cos has no upstream branch. Branch-ul tău nu e legat încă de niciun branch de pe server, deci git push nu știe unde să-l trimită. Urcă-l prima dată cu git push -u origin feature/cos; după aceea ajunge git push simplu. nothing added to commit but untracked files present (use "git add" to track) Ai fișiere noi în proiect, dar niciunul nu e în staging, deci commit-ul nu are ce salva. Adaugă-le cu git add nume-fișier (sau git add . pentru toate), apoi rulează din nou git commit. Î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.
