...
Eroare Git · Branch-uri, merge și conflicte

fatal: cannot force update the branch 'main' used by worktree at '/home/elev/proiect'

Pe scurt

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.

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

Ce înseamnă

git branch -f main <commit> mută eticheta main pe alt commit fără să atingă fișierele din folder. Dacă main e branch-ul pe care lucrezi (cel spre care arată HEAD), mutarea ar lăsa folderul și staging-ul nepotrivite cu noul commit, așa că Git refuză: fatal: cannot force update the branch 'main' used by worktree at '/home/elev/proiect'. Calea de la final e folderul unde branch-ul e folosit (aici chiar folderul tău; la git worktree, poate fi alt folder).

În versiunile mai vechi, mesajul era fatal: Cannot force update the current branch.. Pentru branch-ul curent ai comenzi făcute exact pentru asta: git reset --hard <commit> mută branch-ul și actualizează folderul (pierzând modificările necomise), iar git merge --ff-only <commit> îl avansează doar dacă se poate fără merge.

De ce apare: cauzele frecvente

1Vrei să aduci main la vârful altui branch

Greșit
BASH
git switch main
git branch -f main feature/plata
Corect
BASH
git switch main
git merge --ff-only feature/plata

Fast-forward mută main înainte și actualizează fișierele, fără să rescrie istoric.

2Vrei să renunți la commit-urile locale

Greșit
BASH
git branch -f main origin/main
Corect
BASH
git fetch origin
git reset --hard origin/main

reset --hard mută branch-ul curent și aduce folderul la același commit. Modificările necomise se pierd, deci verifică întâi git status.

3Voiai să muți alt branch

Greșit
BASH
git branch -f main 3f2a1b4   # ești pe main
Corect
BASH
git switch feature
git branch -f main 3f2a1b4

branch -f merge pe orice branch care nu e folosit în folderul curent.

Repară tu

Repară eroarea, direct în pagină

Branch-ul feature/plata are deja un commit nou peste main, iar tu vrei ca main să ajungă la același commit. Ești pe main și git branch -f main feature/plata dă cannot force update the branch 'main' used by worktree. Adu main la vârful lui feature/plata, fără commit de merge.

Indiciu

Pe branch-ul curent, un merge care doar avansează branch-ul e varianta sigură.

Alte forme ale mesajului

  • fatal: Cannot force update the current branch.
  • fatal: cannot force update the branch 'feature/cos' used by worktree at '/home/elev/proiect-cos'

Cum o eviți pe viitor

  • Pentru branch-ul curent folosește git reset sau git merge --ff-only; păstrează git branch -f pentru celelalte branch-uri.
  • Înainte de orice reset --hard, rulează git status și salvează ce contează cu git stash.
  • Dacă folosești git worktree, verifică cu git worktree list ce branch e deschis în fiecare folder.

Întrebări frecvente

Care e diferența dintre git branch -f și git reset --hard?

Ambele mută un branch pe alt commit. branch -f nu atinge folderul, de aceea merge doar pe branch-uri care nu sunt deschise. reset --hard lucrează pe branch-ul curent și rescrie și folderul, și staging-ul.

Ce e worktree-ul din mesaj?

Un folder de lucru legat de repository. Folderul tău e worktree-ul principal; cu git worktree add poți avea mai multe, fiecare pe alt branch. Un branch deschis într-unul nu poate fi mutat din altul.

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.