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

fatal: this operation must be run in a work tree

Pe scurt

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

Greșit
BASH
cd .git
git status
Corect
BASH
cd ..
git status

Comenzile pe fișiere se rulează din folderul proiectului, nu din .git.

2Ești într-un repository bare

Greșit
BASH
cd ~/server.git
git status
Corect
BASH
git clone ~/server.git ~/lucru
cd ~/lucru
git status

Clona are folder de lucru; repository-ul bare rămâne doar pentru push și pull.

3core.bare setat greșit

Greșit
BASH
git config core.bare true   # într-un proiect normal
git status
Corect
BASH
git config core.bare false
git status

Cu core.bare=true, Git ignoră folderul de lucru chiar dacă există.

Repară tu

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.

Alte forme ale mesajului

  • fatal: this operation must be run in a work tree
  • fatal: 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ște git 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

← 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.