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

fatal: Remote branch develop not found in upstream origin

Pe scurt

Ai cerut la git clone -b un branch care nu există pe server. Vezi branch-urile reale cu git ls-remote --heads <url> (sau pe GitHub) și clonează cu numele corect, de exemplu git clone -b dev <url>.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

git clone -b nume url clonează repository-ul și te pune direct pe branch-ul nume. Dacă serverul nu are acel branch, Git se oprește la final cu fatal: Remote branch develop not found in upstream origin (origin e numele implicit al remote-ului la clonare) și nu termină clonarea.

De obicei numele e ghicit: echipa folosește dev, nu develop, sau master în loc de main, sau branch-ul de feature are alt prefix. Poți afla branch-urile fără să clonezi: git ls-remote --heads https://github.com/firma/site.git. Alt caz: un script de CI sau un Dockerfile cere un branch care a fost redenumit sau șters. Mesajul apare și la git clone --branch v2.0 când tagul nu există.

De ce apare: cauzele frecvente

1Numele branch-ului e altul pe server

Greșit
BASH
git clone -b develop https://github.com/elev/site.git
Corect
BASH
git ls-remote --heads https://github.com/elev/site.git
git clone -b dev https://github.com/elev/site.git

ls-remote --heads listează branch-urile reale. Cu numele exact, clonarea se termină.

2Branch-ul a fost redenumit sau șters, iar scriptul are numele vechi

Greșit
BASH
git clone -b master https://github.com/elev/site.git
Corect
BASH
git clone -b main https://github.com/elev/site.git

Multe proiecte au trecut de la master la main. Actualizează numele în script.

Repară tu

Repară eroarea, direct în pagină

Vrei să clonezi proiectul https://github.com/elev/site.git direct pe branch-ul de dezvoltare, în folderul ~/site-dev. git clone -b develop https://github.com/elev/site.git site-dev dă fatal: Remote branch develop not found in upstream origin. Află numele real al branch-ului și clonează-l în ~/site-dev.

Indiciu

Pe server există doar două branch-uri; numele celui de dezvoltare e mai scurt.

Alte forme ale mesajului

  • fatal: Remote branch master not found in upstream origin
  • warning: Could not find remote branch develop to clone.

Cum o eviți pe viitor

  • Verifică branch-urile cu git ls-remote --heads <url> înainte să scrii comanda în scripturi.
  • Când nu ai nevoie de un branch anume, clonează fără -b și schimbă apoi cu git switch.
  • În CI, folosește variabila cu branch-ul curent oferită de platformă în loc de un nume fix.

Întrebări frecvente

Pot clona întâi și schimba branch-ul după?

Da: git clone url, apoi cd în folder și git switch dev. Git creează branch-ul local din origin/dev.

Funcționează -b și cu taguri?

Da, git clone -b v1.0 url te pune pe tag, în detached HEAD. Dacă tagul nu există, primești același tip de mesaj.

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.