fatal: not in a git directory
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
cd ~
git config user.name "Ana Pop"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
git config user.email ana@example.com # imediat după instalaregit config --global user.email ana@example.com--global scrie în ~/.gitconfig, care există independent de orice repository.
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.
Reparația
Vezi eroarea:
git config user.name "Ana Pop"Intră în proiect și setează numele local:
cd ~/proiect
git config user.name "Ana Pop"
git config --show-origin user.nameRezultat: setarea vine din .git/config, cu valoarea Ana Pop.
De ce merge
Fără --global, git config scrie în .git/config al repository-ului curent, iar în ~ nu exista niciun repository. După cd ~/proiect, comanda scrie setarea în configurarea proiectului. Numele global rămâne Elev Academia, deci celelalte proiecte nu sunt afectate. Poți verifica oricând de unde vine o setare cu git config --show-origin.
Alte forme ale mesajului
fatal: --local can only be used inside a git repositoryfatal: not in a git directory
Cum o eviți pe viitor
- La prima configurare a Git, folosește
--globalpentru nume, email și editor. - Pentru setări de proiect, intră întâi în folderul lui și verifică cu
git statuscă 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
*** Please tell me who you are. Git nu știe ce nume și ce email să scrie ca autor al commit-ului. Setează-le o singură dată, cu git config --global user.name "Numele Tău" și git config --global user.email "tu@exemplu.ro", apoi rulează din nou git commit. error: key does not contain a section: name Setările Git au forma secțiune.cheie, iar tu ai scris doar cheia (name în loc de user.name). Rulează git config --global user.name "Ana Pop" (la fel pentru user.email). fatal: not a git repository (or any of the parent directories): .git Git nu găsește niciun repository în folderul curent și nici în folderele de deasupra lui. Fie ești în folderul greșit (verifică cu pwd și mergi cu cd în proiect), fie proiectul nu a fost inițializat încă și trebuie să rulezi git init. Î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.
