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

error: The following untracked working tree files would be overwritten by checkout

Pe scurt

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.

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

Ce înseamnă

Fișierele untracked nu sunt în niciun commit, deci Git nu are nicio copie a lor. Dacă branch-ul pe care vrei să treci conține un fișier cu același nume, schimbarea ar trebui să-l scrie peste al tău, iar fișierul tău s-ar pierde definitiv. Git refuză, listează fișierele și îți cere Please move or remove them before you switch branches.

Situația apare des cu fișiere de configurare sau generate: le-ai creat local pe un branch unde nu existau, iar pe alt branch cineva le-a comis. Același mesaj apare și cu by merge (la git merge sau git pull), când commit-urile care vin aduc un fișier cu numele unuia dintre fișierele tale noi. Uită-te întâi la conținut: dacă e important, păstrează-l sub alt nume sau în alt folder.

De ce apare: cauzele frecvente

1Un fișier local are același nume cu unul comis pe alt branch

Greșit
BASH
git switch feature/setari
# config.json local, necomis
Corect
BASH
mv config.json config.local.json
git switch feature/setari

După redenumire, numele config.json e liber, iar fișierul tău e păstrat ca config.local.json.

2Fișiere generate, pe care le poți crea din nou

Greșit
BASH
git pull
# dist/app.js ar fi suprascris
Corect
BASH
rm -r dist
git pull

Fișierele de build se regenerează oricând. Le poți șterge și apoi le pui în .gitignore.

3Colegul a comis un fișier pe care tu îl aveai doar local

Greșit
BASH
git merge feature/setari
Corect
BASH
mkdir -p ~/backup
mv config.json ~/backup/
git merge feature/setari

Pui fișierul tău deoparte, faci merge-ul, apoi compari cele două versiuni și le combini dacă e nevoie.

Repară tu

Repară eroarea, direct în pagină

Pe main ți-ai creat local un config.json (tema întunecată), necomis. Pe branch-ul feature/setari, echipa a comis un config.json comun. git switch feature/setari dă The following untracked working tree files would be overwritten by checkout. Păstrează-ți fișierul ca config.local.json și treci pe feature/setari.

Indiciu

Eliberează numele fișierului fără să-i pierzi conținutul.

Alte forme ale mesajului

  • error: The following untracked working tree files would be overwritten by merge:
  • Please move or remove them before you switch branches.
  • Please move or remove them before you merge.

Cum o eviți pe viitor

  • Pune în .gitignore fișierele locale (configurări personale, build-uri), ca să nu intre niciodată în conflict cu ce comit alții.
  • Pentru configurări, folosește un model comis (config.example.json) și un fișier local ignorat.
  • Rulează git status înainte să schimbi branch-ul și uită-te la Untracked files.

Întrebări frecvente

Pot forța schimbarea branch-ului?

Da, git switch -f sau git checkout -f, dar fișierul tău neurmărit se pierde fără nicio copie. Fă asta doar dacă ești sigur că nu-ți trebuie.

De ce git stash nu rezolvă problema?

git stash simplu nu salvează fișierele neurmărite. Merge doar git stash -u, care le include.

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.