fatal: this operation must be run in a work tree
Rulezi o comandă care lucrează cu fișiere (git status, add, checkout) într-un repository fără folder de lucru: un repository bare sau chiar în interiorul folderului .git. Ieși din .git cu cd .., sau clonează repository-ul bare într-un folder normal și lucrează acolo.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un work tree e folderul cu fișierele proiectului, cel pe care îl editezi. Comenzi ca git status, git add, git restore sau git checkout compară fișierele de acolo cu istoricul, deci au nevoie de el. Un repository bare (de exemplu server.git, creat cu git init --bare sau git clone --bare) are doar istoricul, fără fișiere, iar folderul .git nu e nici el un work tree. Dacă rulezi comenzile în aceste locuri, Git răspunde fatal: this operation must be run in a work tree.
Cazurile obișnuite: ai intrat cu cd .git ca să te uiți la configurare și ai rămas acolo, ești pe server în folderul repository-ului bare, sau core.bare a ajuns true într-un repository normal. Verifici cu git rev-parse --is-bare-repository și git rev-parse --is-inside-git-dir.
De ce apare: cauzele frecvente
1Ești în interiorul folderului .git
cd .git
git statuscd ..
git statusComenzile pe fișiere se rulează din folderul proiectului, nu din .git.
2Ești într-un repository bare
cd ~/server.git
git statusgit clone ~/server.git ~/lucru
cd ~/lucru
git statusClona are folder de lucru; repository-ul bare rămâne doar pentru push și pull.
3core.bare setat greșit
git config core.bare true # într-un proiect normal
git statusgit config core.bare false
git statusCu core.bare=true, Git ignoră folderul de lucru chiar dacă există.
Repară eroarea, direct în pagină
Ești în ~/site.git, repository-ul bare de pe care echipa face push și pull, iar git status dă this operation must be run in a work tree. Clonează-l în folderul ~/lucru, intră în clonă și verifică acolo starea cu git status.
Indiciu
Un repository bare se folosește ca remote: îl clonezi ca pe unul de pe GitHub.
Reparația
Vezi eroarea:
git statusClonează și lucrează în clonă:
git clone ~/site.git ~/lucru
cd ~/lucru
git statusRezultat: în ~/lucru ai fișierele proiectului, iar git status funcționează.
De ce merge
Repository-ul bare nu are folder de lucru, deci comenzile care compară fișiere nu au ce compara. Clona din ~/lucru are tot istoricul și fișierele, iar origin arată spre ~/site.git. Lucrezi și comiți în clonă, apoi urci modificările înapoi cu git push.
Alte forme ale mesajului
fatal: this operation must be run in a work treefatal: not a git repository (or any of the parent directories): .git
Cum o eviți pe viitor
- Nu lucra în interiorul folderului
.git; pentru configurare foloseștegit config --edit. - Denumește repository-urile bare cu terminația
.git(server.git), ca să le recunoști imediat. - Dacă un proiect normal începe brusc să dea eroarea, verifică
git config core.bare.
Întrebări frecvente
Ce comenzi merg totuși într-un repository bare?
Cele care lucrează doar cu istoricul: git log, git branch, git tag, git show, git fetch, git config. Nu merg cele care au nevoie de fișiere: status, add, commit, checkout, restore.
Cum transform un repository bare într-unul normal?
Cel mai simplu e să-l clonezi: git clone server.git proiect. Clona are tot istoricul și un folder de lucru.
Erori înrudite
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. remote: error: refusing to update checked out branch: refs/heads/main Faci push într-un repository obișnuit (cu folder de lucru) chiar pe branch-ul deschis acolo, iar Git refuză ca să nu-i strice fișierele. Folosește ca server un repository bare (git init --bare) sau un serviciu ca GitHub; pe termen scurt, trece repository-ul de pe server pe alt branch. 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. Î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.
