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

error: src refspec main does not match any

Pe scurt

Î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

Greșit
BASH
git init
git remote add origin https://github.com/elev/portofoliu.git
git push -u origin main
Corect
BASH
git add README.md
git commit -m "Primul commit"
git push -u origin main

Primul commit creează efectiv branch-ul main. Abia apoi există ceva de urcat.

2Branch-ul tău se numește master

Greșit
BASH
git branch
# * master
git push -u origin main
Corect
BASH
git branch -M main
git push -u origin main

git 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

Greșit
BASH
git push origin feature/Login
Corect
BASH
git push origin feature/login

Numele trebuie să fie exact cel din git branch, inclusiv literele mari.

Repară tu

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.

Alte forme ale mesajului

  • error: src refspec master does not match any
  • error: 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

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