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

fatal: couldn't find remote ref master

Pe scurt

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

Greșit
BASH
git pull origin master
Corect
BASH
git pull origin main

Branch-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

Greșit
BASH
git pull origin feature-cos
Corect
BASH
git fetch
git branch -r
git pull origin feature/cos

Git compară numele exact. git branch -r arată numele așa cum sunt pe server.

3Branch-ul a fost șters de pe server

Greșit
BASH
git pull origin feature/vechi
Corect
BASH
git fetch --prune
git branch -r

După merge-ul unui pull request, branch-ul e adesea șters de pe GitHub. --prune curăță și referințele locale vechi.

Repară tu

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.

Alte forme ale mesajului

  • fatal: couldn't find remote ref main
  • fatal: couldn't find remote ref feature-cos
  • fatal: couldn't find remote ref refs/heads/master

Cum o eviți pe viitor

  • După clone, rulează git branch -r ca să vezi cum se numește branch-ul principal.
  • Setează upstream-ul o dată (git push -u sau git branch -u origin/main) și apoi folosește doar git pull, fără nume.
  • Când copiezi comenzi din tutoriale vechi, înlocuiește master cu 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

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