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

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

Pe scurt

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

Greșit
BASH
echo "port = 3000" > config.txt
git switch feature/api
Corect
BASH
git stash
git switch feature/api
# mai târziu, înapoi pe main:
git switch main
git stash pop

git 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

Greșit
BASH
git switch feature/api
Corect
BASH
git commit -am "Port local 3000"
git switch feature/api

Un commit pe branch-ul curent păstrează modificarea acolo unde îi e locul.

3Modificarea nu mai e necesară

Greșit
BASH
git switch feature/api
Corect
BASH
git restore config.txt
git switch feature/api

git restore readuce fișierul la versiunea din ultimul commit. Atenție: modificarea se pierde definitiv.

Repară tu

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.

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 în git 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

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