...
Eroare Git · Configurare, comenzi și mediul de lucru

hint: Using 'master' as the name for the initial branch.

Pe scurt

Nu e o eroare: git init te anunță că branch-ul inițial se numește master, pentru că nu ai setat alt nume implicit. Ca toate proiectele noi să pornească pe main, rulează git config --global init.defaultBranch main; pentru proiectul curent, git branch -m main.

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

Ce înseamnă

Mesajul complet începe cu hint: Using 'master' as the name for the initial branch. This default branch name și continuă cu instrucțiunile. Git îți spune trei lucruri: a numit primul branch master, numele implicit s-ar putea schimba în versiunile viitoare și poți alege tu numele cu git config --global init.defaultBranch <name>. Pentru repository-ul deja creat, îl redenumești cu git branch -m <name>.

Contează pentru că GitHub, GitLab și majoritatea echipelor folosesc acum main. Dacă local ai master și pe server main, apar erori ca src refspec main does not match any sau două branch-uri principale. Setarea se face o singură dată pe calculator; Git for Windows o propune deja la instalare.

De ce apare: cauzele frecvente

1Nu ai setat numele implicit al branch-ului

Greșit
BASH
git init
Corect
BASH
git config --global init.defaultBranch main
git init

Cu setarea globală, toate repository-urile noi pornesc direct pe main, fără mesaj.

2Repository-ul e deja creat pe master

Greșit
BASH
git init
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 (chiar și înainte de primul commit), deci numele local coincide cu cel de pe server.

Repară tu

Repară eroarea, direct în pagină

Pe calculatorul nou, git init în ~/site a afișat hint: Using 'master' as the name for the initial branch.. Echipa folosește main. Redenumește branch-ul proiectului în main și setează global main ca nume implicit pentru repository-urile viitoare.

Indiciu

Ai două lucruri de făcut: o setare globală și o redenumire în proiectul curent.

Alte forme ale mesajului

  • hint: Using 'master' as the name for the initial branch. This default branch name hint: is subject to change.
  • hint: git config --global init.defaultBranch <name>
  • hint: git branch -m <name>

Cum o eviți pe viitor

  • Rulează o dată, pe fiecare calculator: git config --global init.defaultBranch main.
  • Verifică cu git config --global --list că setarea există.
  • Când creezi un repository pe GitHub și unul local, folosește același nume de branch principal.
  • Pe GitHub, verifică în Settings, Repositories, numele implicit pentru repository-urile noi, ca să fie același cu cel local.

Întrebări frecvente

Trebuie să redenumesc proiectele vechi de pe master?

Nu e obligatoriu. Dacă echipa vrea, redenumirea se face pe GitHub (Settings, Branches) și apoi local; altfel, proiectele vechi pot rămâne pe master.

Merge git branch -m main înainte de primul commit?

Da, în Git 2.30 și mai nou. Branch-ul încă „nenăscut” primește doar alt nume.

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.