...
Eroare Git · Modificări locale, checkout și stash

error: Your local changes to the following files would be overwritten by merge

Pe scurt

Merge-ul (sau pull-ul) trebuie să modifice un fișier în care ai modificări necomise, iar Git nu vrea să ți le strice. Fă commit cu ele sau pune-le deoparte cu git stash, rulează merge-ul sau pull-ul, apoi git stash pop.

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

Ce înseamnă

Un merge scrie în working directory rezultatul combinării branch-urilor. Dacă un fișier pe care merge-ul trebuie să-l schimbe are modificări necomise, Git nu are unde să le păstreze: dacă merge-ul s-ar opri cu un conflict, munca ta s-ar amesteca cu marcajele și n-ai mai putea reveni curat. De aceea refuză înainte să înceapă și listează fișierele, cu Please commit your changes or stash them before you merge.

Mesajul apare cel mai des la git pull, care face un merge după fetch. Nimic nu s-a schimbat încă. Ai trei variante: commit (modificarea e gata), git stash urmat de merge și git stash pop (modificarea e neterminată), sau git restore fișier (nu ai nevoie de ea).

De ce apare: cauzele frecvente

1Lucru neterminat în fișierul pe care îl schimbă merge-ul

Greșit
BASH
git merge livrare-gratuita
Corect
BASH
git stash
git merge livrare-gratuita
git stash pop

Stash-ul scoate modificarea din cale, merge-ul se face curat, iar stash pop o pune înapoi peste rezultat.

2git pull cu modificări locale

Greșit
BASH
git pull
Corect
BASH
git commit -am "Titlul nou"
git pull

După commit, modificarea ta e parte din istoric și pull-ul o combină cu cea de pe server, ca pe orice alt commit.

3Modificări de test pe care nu le mai vrei

Greșit
BASH
git pull
Corect
BASH
git restore setari.txt
git pull

git restore aruncă modificarea locală, iar pull-ul poate actualiza fișierul.

Repară tu

Repară eroarea, direct în pagină

Pe main ai schimbat local titlul din setari.txt în Magazin Online, fără commit. Branch-ul livrare-gratuita a schimbat în același fișier taxa de livrare în 0. git merge livrare-gratuita dă Your local changes ... would be overwritten by merge. Unește branch-ul și păstrează modificarea ta necomisă (stash-ul trebuie să rămână gol).

Indiciu

Scoate temporar modificarea din cale, unește branch-ul, apoi aplic-o înapoi.

Alte forme ale mesajului

  • Please commit your changes or stash them before you merge.
  • error: Your local changes to the following files would be overwritten by merge: setari.txt Please commit your changes or stash them before you merge. Aborting
  • Merge with strategy ort failed.

Cum o eviți pe viitor

  • Pornește merge-ul și pull-ul cu working directory-ul curat (git status).
  • Fă commit înainte de pull, chiar și un commit mic.
  • Pentru pull, poți folosi git pull --autostash (cu rebase), care face stash-ul automat și îl aplică la final.

Întrebări frecvente

Ce fac dacă git stash pop dă conflict?

Rezolvi conflictul în fișier ca la un merge și rulezi git add. Stash-ul nu se șterge în acest caz, deci după rezolvare rulezi git stash drop.

De ce Git nu combină pur și simplu modificarea mea cu merge-ul?

Pentru că modificarea ta nu e în niciun commit. Dacă rezultatul ar ieși prost, n-ai avea de unde să o recuperezi. Git preferă să se oprească.

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.