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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când schimbi branch-ul, Git rescrie fișierele din working directory cu versiunile de pe branch-ul nou. Modificările necomise sunt de obicei „cărate” cu tine, dar doar dacă fișierul e identic pe ambele branch-uri. Dacă fișierul modificat de tine diferă și între cele două branch-uri, Git ar trebui să-ți arunce modificarea ca să pună versiunea celuilalt branch, așa că refuză și listează fișierele.
Mesajul apare la fel la git switch și la git checkout (scrie by checkout în ambele cazuri) și se termină cu Please commit your changes or stash them before you switch branches. și Aborting. Nimic nu s-a schimbat. Alegi ce faci cu modificarea: o salvezi în commit (dacă e gata), o pui deoparte cu git stash (dacă e neterminată) sau renunți la ea cu git restore.
De ce apare: cauzele frecvente
1Lucru neterminat pe care vrei să-l păstrezi
echo "port = 3000" > config.txt
git switch feature/apigit stash
git switch feature/api
# mai târziu, înapoi pe main:
git switch main
git stash popgit stash salvează modificarea și curăță working directory-ul, deci schimbarea branch-ului nu mai pierde nimic.
2Modificarea e gata și ține de branch-ul curent
git switch feature/apigit commit -am "Port local 3000"
git switch feature/apiUn commit pe branch-ul curent păstrează modificarea acolo unde îi e locul.
3Modificarea nu mai e necesară
git switch feature/apigit restore config.txt
git switch feature/apigit restore readuce fișierul la versiunea din ultimul commit. Atenție: modificarea se pierde definitiv.
Repară eroarea, direct în pagină
Pe main ai schimbat local portul din config.txt în 3000, dar nu ești gata să faci commit. Trebuie să treci urgent pe feature/api, iar git switch feature/api dă Your local changes to the following files would be overwritten by checkout. Pune modificarea deoparte, fără commit, și treci pe feature/api.
Indiciu
Există o comandă care salvează temporar modificările necomise și curăță working directory-ul.
Reparația
Vezi eroarea, apoi pune modificarea deoparte:
git switch feature/api
git stashAcum working directory-ul e curat și poți schimba branch-ul:
git switch feature/api
git stash listRezultat: ești pe feature/api, config.txt arată port = 9000, iar git stash list afișează stash@{0}: WIP on main: .... Când revii pe main, git stash pop îți readuce portul 3000.
De ce merge
config.txt era diferit pe cele două branch-uri, deci schimbarea ar fi suprascris modificarea ta. git stash o salvează într-un commit special, în afara branch-urilor, și readuce fișierul la ultimul commit. Cu working directory-ul curat, git switch poate pune liniștit versiunea de pe feature/api. Modificarea rămâne în stash până o aplici cu git stash pop.
Alte forme ale mesajului
Please commit your changes or stash them before you switch branches.error: Your local changes to the following files would be overwritten by checkout: config.txt Please commit your changes or stash them before you switch branches. Aborting
Cum o eviți pe viitor
- Rulează
git statusînainte să schimbi branch-ul. - Fă commit-uri mici și dese, ca să ai rar modificări necomise.
- Folosește
git stash -m "descriere"pentru lucrul neterminat, ca să-l recunoști îngit stash list. - Evită
git switch -f/git checkout -f: forțează schimbarea și îți aruncă modificările.
Întrebări frecvente
De ce uneori pot schimba branch-ul cu modificări necomise, alteori nu?
Dacă fișierele modificate sunt identice pe cele două branch-uri, Git le lasă neatinse și le ia cu tine. Eroarea apare doar când un fișier modificat diferă între branch-uri.
Stash-ul e legat de branch?
Nu. Stash-ul e comun pentru tot repository-ul, deci îl poți aplica pe orice branch. De obicei îl aplici înapoi pe branch-ul pe care l-ai creat.
Erori înrudite
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. error: The following untracked working tree files would be overwritten by checkout Ai un fișier neurmărit care există și în commit-urile branch-ului pe care vrei să treci, iar schimbarea l-ar suprascrie. Mută-l sau redenumește-l (sau șterge-l, dacă nu-ți trebuie), apoi rulează din nou git switch. No stash entries found. Stash-ul e gol: git stash pop sau git stash apply nu au ce aplica. Fie stash-ul a fost deja aplicat și șters, fie git stash nu a salvat nimic (de exemplu pentru că aveai doar fișiere noi). Verifică cu git stash list și git status unde sunt modificările. Î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.
