...
Eroare Git · Branch-uri, merge și conflicte

fatal: not a valid object name: 'main'

Pe scurt

Încerci să creezi un branch într-un repository fără niciun commit, iar noul branch nu are de unde să pornească. Fă întâi primul commit pe main, apoi git branch nume (sau git switch -c nume).

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

Ce înseamnă

Un branch este doar un nume care indică spre un commit. git branch feature/meniu creează un nume nou care indică spre commit-ul curent. Dacă repository-ul nu are încă niciun commit, main este doar un nume „nenăscut” (unborn), care nu indică spre nimic, așa că Git spune că main nu e un obiect valid din care să pornească noul branch.

Același mesaj apare dacă dai ca punct de plecare un nume care nu există, de exemplu git branch fix origin/main înainte de primul git fetch. Reparația tipică: git add, git commit, apoi creezi branch-ul.

De ce apare: cauzele frecvente

1Repository nou, fără commit

Greșit
BASH
git init
git branch feature/meniu
Corect
BASH
git init
git add .
git commit -m "Primul commit"
git branch feature/meniu

După primul commit, main indică spre un commit real, iar noul branch pornește din el.

2Punctul de plecare nu există

Greșit
BASH
git branch fix release
Corect
BASH
git branch -a
git branch fix release-1.0

Al doilea argument trebuie să fie un branch, un tag sau un commit existent. git branch -a îți arată ce nume există.

Repară tu

Repară eroarea, direct în pagină

Ai inițializat repository-ul și ai creat README.md, apoi git branch feature/meniu dă fatal: not a valid object name: 'main'. Salvează README.md pe main cu mesajul Primul commit, apoi creează branch-ul feature/meniu și treci pe el.

Indiciu

Un branch nou are nevoie de un commit din care să pornească.

Alte forme ale mesajului

  • fatal: not a valid object name: 'master'
  • fatal: Not a valid object name: 'main'.

Cum o eviți pe viitor

  • Fă un commit de pornire imediat după git init (README, .gitignore).
  • Verifică cu git log --oneline că există cel puțin un commit înainte să creezi branch-uri.
  • Când pornești dintr-un branch de pe server, rulează întâi git fetch.
  • Când nu ești sigur ce nume există, listează-le cu git branch -a și git tag înainte să le folosești ca punct de plecare.

Întrebări frecvente

De ce git switch -c merge într-un repository gol, iar git branch nu?

git switch -c dev într-un repository fără commit-uri doar schimbă numele branch-ului nenăscut. git branch dev trebuie să creeze un al doilea nume care indică spre un commit, iar acel commit nu există.

Am pierdut ceva?

Nu. Comanda nu a creat nimic. Fă primul commit și reia comanda.

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.