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

error: you need to resolve your current index first

Pe scurt

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

Greșit
BASH
git merge reducere
# CONFLICT în pret.txt
git switch hotfix
Corect
BASH
git 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

Greșit
BASH
git checkout feature
# error: you need to resolve your current index first
Corect
BASH
git status
# rezolvă fișierele de la Unmerged paths
git add pret.txt
git commit

git status îți arată că ești încă în merge. După commit, merge-ul e gata și poți schimba branch-ul.

Repară tu

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

Alte forme ale mesajului

  • pret.txt: needs merge
  • error: 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

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