error: Your local changes to the following files would be overwritten by merge
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
git merge livrare-gratuitagit stash
git merge livrare-gratuita
git stash popStash-ul scoate modificarea din cale, merge-ul se face curat, iar stash pop o pune înapoi peste rezultat.
2git pull cu modificări locale
git pullgit commit -am "Titlul nou"
git pullDupă 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
git pullgit restore setari.txt
git pullgit restore aruncă modificarea locală, iar pull-ul poate actualiza fișierul.
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.
Reparația
Vezi eroarea, apoi pune modificarea deoparte și unește branch-ul:
git merge livrare-gratuita
git stash
git merge livrare-gratuitaAplică înapoi modificarea și verifică fișierul:
git stash pop
cat setari.txtRezultat: setari.txt conține și titlu = Magazin Online (modificarea ta, necomisă), și livrare = 0 (din branch), iar git stash list e gol.
De ce merge
Merge-ul trebuia să scrie în setari.txt, unde aveai o modificare care nu exista în niciun commit, deci Git a refuzat. După git stash, fișierul a revenit la ultimul commit și merge-ul (un fast-forward) s-a făcut curat. git stash pop a aplicat modificarea ta peste versiunea nouă: liniile schimbate erau diferite (titlul și livrarea), deci s-au combinat fără conflict, iar intrarea din stash a fost ștearsă.
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. AbortingMerge 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
error: Your local changes to the following files would be overwritten by checkout Ai modificări necomise într-un fișier care arată altfel pe branch-ul pe care vrei să treci, iar schimbarea branch-ului le-ar șterge. Salvează-le întâi: git stash (le pui deoparte) sau git commit, apoi git switch; dacă nu-ți trebuie, git restore fișier. error: cannot pull with rebase: You have unstaged changes. Pull-ul cu rebase are nevoie de un working directory curat, iar tu ai modificări necomise. Pune-le deoparte cu git stash, rulează git pull, apoi git stash pop (sau folosește direct git pull --rebase --autostash). 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. Î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.
