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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un repository creat cu git init are un folder de lucru și un branch deschis (de obicei main). Dacă cineva ar face push în acel branch, istoricul s-ar muta, dar fișierele din folder și staging-ul de acolo ar rămâne pe versiunea veche, ca și cum cineva ar fi anulat toate modificările. De aceea Git refuză: remote: error: refusing to update checked out branch: refs/heads/main, iar la final vezi ! [remote rejected] main -> main (branch is currently checked out).
Eroarea apare când folosești un folder obișnuit ca „server”: un folder partajat, un stick, alt folder de pe același calculator, un server SSH pe care ai rulat git init. Repository-urile care primesc push trebuie să fie bare (git init --bare server.git), adică fără folder de lucru, exact cum sunt cele de pe GitHub.
De ce apare: cauzele frecvente
1Serverul e un repository obișnuit
ssh server "git init /srv/proiect"
git push origin mainssh server "git init --bare /srv/proiect.git"
git remote set-url origin server:/srv/proiect.git
git push origin mainUn repository bare nu are folder de lucru, deci nu are ce să strice un push.
2Ai clonat un folder local și faci push înapoi
git clone ~/server ~/proiect
cd ~/proiect
git push origin maingit clone --bare ~/server ~/server.git
git remote set-url origin ~/server.git
git push origin mainFaci o copie bare a serverului și îl folosești pe aceea ca remote.
3Soluție rapidă pe un server de test
git push origin main # main e deschis pe servercd ~/server && git switch -c lucru
cd ~/proiect && git push origin mainDacă main nu mai e branch-ul deschis pe server, push-ul în el e permis. Fișierele din folderul serverului rămân pe lucru.
Repară eroarea, direct în pagină
Folosești folderul ~/server (un repository obișnuit, pe main) ca server de test, iar ~/proiect e clona lui. git push origin main din ~/proiect e respins cu refusing to update checked out branch. Nimeni nu lucrează în ~/server: trece-l pe un branch nou, lucru, apoi urcă din nou main din ~/proiect.
Indiciu
Push-ul în main e refuzat doar cât timp main e deschis în folderul serverului.
Reparația
Vezi eroarea:
git push origin mainEliberează main pe server și urcă din nou:
cd ~/server
git switch -c lucru
cd ~/proiect
git push origin mainRezultat: main de pe server are commit-ul tău. Pe termen lung, folosește un repository bare (git clone --bare ~/server ~/server.git).
De ce merge
Git refuza push-ul pentru că main era branch-ul deschis în ~/server, iar fișierele de acolo ar fi rămas în urmă față de istoric. După git switch -c lucru pe server, main nu mai e folosit de folderul lui, deci push-ul îl poate actualiza. Pe un server adevărat, varianta corectă e un repository bare, creat cu git init --bare.
Alte forme ale mesajului
! [remote rejected] main -> main (branch is currently checked out)remote: error: By default, updating the current branch in a non-bare repository remote: is denied, because it will make the index and work tree inconsistent
Cum o eviți pe viitor
- Repository-urile care primesc push le creezi mereu cu
git init --bare(saugit clone --bare), cu nume terminat în.git. - Pentru proiecte în echipă, folosește un serviciu de găzduire (GitHub, GitLab, Bitbucket), unde repository-urile sunt bare.
- Nu modifica
receive.denyCurrentBranchdecât dacă știi exact cum se actualizează folderul de pe server (de exempluupdateInsteadpentru un site simplu).
Întrebări frecvente
Ce e un repository bare?
Un repository fără folder de lucru: doar conținutul lui .git (obiecte, branch-uri, taguri). Nu poți edita fișiere în el, dar poți face push și clone. Așa sunt repository-urile de pe GitHub.
Ce face receive.denyCurrentBranch updateInstead?
Permite push în branch-ul deschis și actualizează și fișierele din folderul serverului, dacă acolo nu sunt modificări necomise. E folosit uneori pentru a publica un site prin push, dar pentru colaborare un repository bare e varianta sigură.
Erori înrudite
hint: Updates were rejected because the remote contains work that you do not have locally. Pe GitHub există commit-uri (ale unui coleg sau făcute din interfața web) pe care tu nu le ai local, așa că push-ul tău le-ar șterge. Adu-le întâi cu git pull (sau git pull --rebase), rezolvă eventualele conflicte, apoi git push din nou. fatal: 'origin' does not appear to be a git repository Repository-ul tău nu are niciun remote numit origin, deci Git tratează cuvântul ca pe o cale și nu găsește nimic acolo. Adaugă remote-ul cu git remote add origin URL (verifică cu git remote -v), apoi git push -u origin main. fatal: cannot force update the branch 'main' used by worktree at '/home/elev/proiect' git branch -f nu poate muta branch-ul pe care ești chiar acum, pentru că fișierele din folder nu s-ar mai potrivi cu el. Pe branch-ul curent folosești git reset --hard <commit> (sau git merge --ff-only), ori treci întâi pe alt branch. Î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.
