error: you need to resolve your current index first
Ai un merge (sau rebase) oprit cu conflicte nerezolvate, iar Git nu te lasă să schimbi branch-ul până nu termini. Fie rezolvi conflictele (git add, apoi git commit), fie renunți la merge cu git merge --abort și abia apoi faci git switch.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Index este numele tehnic al staging area. În timpul unui merge cu conflicte, indexul conține fișiere „unmerged”, cu mai multe versiuni în același timp (a ta, a celuilalt branch și cea de bază). Cât timp există astfel de fișiere, Git refuză comenzile care ar trebui să rescrie indexul: git switch, git checkout alt-branch, un nou git merge.
Sub mesaj, Git listează fișierele cu probleme: pret.txt: needs merge. Rulează git status: secțiunea Unmerged paths arată exact ce e în conflict și ce comenzi ai la dispoziție. Ai două drumuri: termini operația (rezolvi fișierele, git add, git commit) sau o anulezi complet cu git merge --abort, care readuce repository-ul la starea dinainte de merge.
De ce apare: cauzele frecvente
1Vrei să schimbi branch-ul în mijlocul unui conflict
git merge reducere
# CONFLICT în pret.txt
git switch hotfixgit merge --abort
git switch hotfix--abort anulează merge-ul și curăță indexul. Apoi poți schimba branch-ul și poți reveni la merge mai târziu.
2Ai uitat că un merge a rămas neterminat
git checkout feature
# error: you need to resolve your current index firstgit status
# rezolvă fișierele de la Unmerged paths
git add pret.txt
git commitgit status îți arată că ești încă în merge. După commit, merge-ul e gata și poți schimba branch-ul.
Repară eroarea, direct în pagină
Ai pornit git merge reducere, a apărut un conflict în pret.txt, iar acum trebuie să lucrezi urgent pe branch-ul hotfix. git switch hotfix dă error: you need to resolve your current index first. Renunță la merge (fără să schimbi main) și treci pe hotfix, cu working directory-ul curat.
Indiciu
Merge-ul neterminat se poate anula complet cu o singură comandă.
Reparația
Vezi eroarea și starea:
git switch hotfix
git statusAnulează merge-ul și schimbă branch-ul:
git merge --abort
git switch hotfix
git statusRezultat: ești pe hotfix, git status spune nothing to commit, working tree clean, iar main are aceleași commit-uri ca înainte de merge.
De ce merge
Cât timp pret.txt era în conflict, indexul avea trei versiuni ale fișierului și Git nu putea face checkout pe alt branch fără să le piardă. git merge --abort șterge starea de merge și readuce working directory-ul și indexul la ultimul commit de pe main. Din acel moment, schimbarea branch-ului e o operație obișnuită. Merge-ul cu reducere îl poți relua oricând mai târziu.
Alte forme ale mesajului
pret.txt: needs mergeerror: Pulling is not possible because you have unmerged files.error: Merging is not possible because you have unmerged files.
Cum o eviți pe viitor
- După orice merge sau pull, citește ieșirea: dacă apare
CONFLICT, rezolvă imediat sau ruleazăgit merge --abort. - Rulează
git statusînainte să schimbi branch-ul. - Folosește un prompt de terminal care arată starea repository-ului (de exemplu
main|MERGING), ca să nu uiți operațiile neterminate.
Întrebări frecvente
Pierd ceva cu git merge --abort?
Pierzi doar rezolvările făcute în timpul merge-ului. Commit-urile ambelor branch-uri rămân neatinse. Dacă aveai modificări necomise înainte de merge, --abort poate avea probleme să le refacă, de aceea e bine să pornești merge-ul cu working directory-ul curat.
Ce fac dacă problema vine dintr-un rebase?
Varianta echivalentă este git rebase --abort (renunți) sau git add urmat de git rebase --continue (termini).
Erori înrudite
CONFLICT (content): Merge conflict in pret.txt Ambele branch-uri au modificat aceleași linii din fișier, iar Git nu poate alege singur. Deschide fișierul, păstrează varianta corectă între marcajele <<<<<<<, ======= și >>>>>>>, șterge marcajele, apoi git add fișier și git commit. error: Committing is not possible because you have unmerged files. Ai rezolvat (sau încă nu) conflictul din fișier, dar nu l-ai marcat ca rezolvat, deci Git nu te lasă să faci commit. Verifică fișierul să nu mai aibă marcaje, rulează git add fișier, apoi git commit. fatal: You have not concluded your merge (MERGE_HEAD exists). Un merge anterior a rămas neterminat: conflictele sunt poate rezolvate, dar commit-ul de merge nu s-a făcut. Rulează git commit ca să-l termini (sau git merge --abort ca să renunți), apoi pornește noul merge sau pull. Î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.
