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

fatal: not in a git directory

Pe scurt

Ai rulat git config fără --global în afara unui repository, iar setarea locală nu are unde să fie scrisă. Intră în folderul proiectului (cd ~/proiect) ca să o setezi doar acolo, sau adaugă --global dacă vrei să fie valabilă pentru toate proiectele.

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

Ce înseamnă

git config are trei niveluri: --system (tot calculatorul), --global (utilizatorul tău, în ~/.gitconfig) și local (un singur repository, în .git/config). Fără opțiune, scrierea se face local. Dacă rulezi comanda într-un folder care nu e repository (de exemplu în folderul personal, imediat după instalarea Git), nu există niciun .git/config și Git se oprește: fatal: not in a git directory.

Apare des la configurarea inițială: tutorialul spune git config user.name "Ana Pop", dar omite --global, sau vrei o setare doar pentru proiectul de la job și uiți să intri în folderul lui. Decide întâi unde trebuie să fie setarea. Pentru numele și emailul de bază: --global. Pentru un email diferit într-un proiect: cd în proiect și comanda fără --global. Varianta fatal: --local can only be used inside a git repository are aceeași cauză, cu --local scris explicit.

De ce apare: cauzele frecvente

1Setare locală rulată din afara proiectului

Greșit
BASH
cd ~
git config user.name "Ana Pop"
Corect
BASH
cd ~/proiect
git config user.name "Ana Pop"

În folderul proiectului există .git/config, unde Git scrie setarea locală.

2Voiai o setare pentru toate proiectele

Greșit
BASH
git config user.email ana@example.com   # imediat după instalare
Corect
BASH
git config --global user.email ana@example.com

--global scrie în ~/.gitconfig, care există independent de orice repository.

Repară tu

Repară eroarea, direct în pagină

Pentru proiectul din ~/proiect vrei să semnezi commit-urile ca Ana Pop, fără să schimbi numele global. Din folderul personal (~) ai rulat git config user.name "Ana Pop" și ai primit fatal: not in a git directory. Setează numele doar pentru acest proiect.

Indiciu

O setare locală are nevoie de folderul repository-ului.

Alte forme ale mesajului

  • fatal: --local can only be used inside a git repository
  • fatal: not in a git directory

Cum o eviți pe viitor

  • La prima configurare a Git, folosește --global pentru nume, email și editor.
  • Pentru setări de proiect, intră întâi în folderul lui și verifică cu git status că e repository.
  • Verifică de unde vine o setare: git config --show-origin user.email.

Întrebări frecvente

Care setare câștigă dacă am și globală, și locală?

Cea locală. Git citește întâi setările de sistem, apoi cele globale, apoi cele locale, iar ultima valoare găsită câștigă.

De ce git config user.name (doar citire) merge oriunde?

La citire, Git caută în toate nivelurile disponibile, iar în afara unui repository le folosește doar pe cele globale și de sistem. Doar scrierea locală are nevoie de un repository.

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.