fatal: couldn't find remote ref master
Pe server nu există branch-ul pe care l-ai cerut, cel mai des pentru că repository-ul folosește main, nu master (sau ai scris greșit numele). Vezi branch-urile reale cu git branch -r sau git ls-remote --heads origin și folosește numele corect.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La git pull origin X sau git fetch origin X, Git îi cere serverului branch-ul X. Dacă serverul nu are o referință cu acel nume, primești couldn't find remote ref X. Nu s-a descărcat și nu s-a modificat nimic.
Cea mai frecventă cauză este diferența master / main: din 2020, GitHub creează repository-urile noi cu main, dar multe tutoriale vechi scriu git pull origin master. Alte cauze: o greșeală de tastare (feature-cos în loc de feature/cos) sau un branch șters între timp de pe server. Lista reală o vezi cu git ls-remote --heads origin sau, după git fetch, cu git branch -r.
De ce apare: cauzele frecvente
1Repository-ul folosește main, nu master
git pull origin mastergit pull origin mainBranch-ul master nu există pe server. Numele principal se vede pe GitHub, în selectorul de branch-uri, sau cu git branch -r.
2Numele branch-ului e scris greșit
git pull origin feature-cosgit fetch
git branch -r
git pull origin feature/cosGit compară numele exact. git branch -r arată numele așa cum sunt pe server.
3Branch-ul a fost șters de pe server
git pull origin feature/vechigit fetch --prune
git branch -rDupă merge-ul unui pull request, branch-ul e adesea șters de pe GitHub. --prune curăță și referințele locale vechi.
Repară eroarea, direct în pagină
Un coleg a urcat pe GitHub commit-ul Pagina Despre. Ai urmat un tutorial vechi și ai rulat git pull origin master, iar Git răspunde fatal: couldn't find remote ref master. Adu commit-ul colegului în branch-ul tău main.
Indiciu
Uită-te cum se numește branch-ul principal pe server.
Reparația
Vezi eroarea, apoi numele branch-urilor de pe server:
git pull origin master
git branch -rAdu modificările de pe main:
git pull origin main
git log --onelineRezultat: git log arată commit-ul Pagina Despre, iar despre.html apare în proiect.
De ce merge
Repository-ul folosește main, deci serverul nu avea niciun branch master de trimis. git branch -r (sau git ls-remote --heads origin) arată numele reale. git pull origin main aduce commit-ul colegului și, pentru că tu nu aveai commit-uri noi, îl aplică prin fast-forward. Fiind pe main cu upstream setat, era suficient și un simplu git pull.
Alte forme ale mesajului
fatal: couldn't find remote ref mainfatal: couldn't find remote ref feature-cosfatal: couldn't find remote ref refs/heads/master
Cum o eviți pe viitor
- După clone, rulează
git branch -rca să vezi cum se numește branch-ul principal. - Setează upstream-ul o dată (
git push -usaugit branch -u origin/main) și apoi folosește doargit pull, fără nume. - Când copiezi comenzi din tutoriale vechi, înlocuiește
mastercu numele real.
Întrebări frecvente
De ce unele proiecte au master și altele main?
Git și GitHub au folosit master ca nume implicit ani de zile. Din 2020, GitHub folosește main pentru repository-urile noi, iar Git îți permite să alegi cu init.defaultBranch. Proiectele vechi au rămas adesea pe master.
Pot redenumi master în main la mine?
Doar dacă ești de acord cu echipa: redenumirea se face pe GitHub (Settings, Branches) și apoi local, cu git branch -m master main și git branch -u origin/main.
Erori înrudite
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. There is no tracking information for the current branch. Branch-ul curent nu are setat un branch de pe server (upstream), deci git pull nu știe de unde să aducă. Setează-l o dată cu git branch --set-upstream-to=origin/nume-branch (sau dă-l explicit: git pull origin nume-branch). fatal: ambiguous argument 'HEAD~3': unknown revision or path not in the working tree. Git nu înțelege argumentul dat: nu e un commit, branch sau tag existent și nici un fișier din proiect. Verifică dacă istoria are destule commit-uri (HEAD~3 cere cel puțin 4), dacă numele branch-ului e corect și, pentru fișiere, pune -- înaintea lor. Î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.
