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.
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
git switch feature/setari
# config.json local, necomismv config.json config.local.json
git switch feature/setariDupă 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
git pull
# dist/app.js ar fi suprascrisrm -r dist
git pullFiș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
git merge feature/setarimkdir -p ~/backup
mv config.json ~/backup/
git merge feature/setariPui fișierul tău deoparte, faci merge-ul, apoi compari cele două versiuni și le combini dacă e nevoie.
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.
Reparația
Vezi eroarea, apoi redenumește fișierul tău:
git switch feature/setari
mv config.json config.local.jsonAcum nu mai există niciun conflict de nume. Schimbă branch-ul:
git switch feature/setari
lsRezultat: ești pe feature/setari, config.json are tema luminoasa (versiunea echipei), iar config.local.json păstrează tema ta.
De ce merge
Fișierul tău nu era în niciun commit, deci Git nu l-ar fi putut recupera după suprascriere și a refuzat schimbarea. Redenumirea a eliberat numele config.json, iar fișierul tău, încă neurmărit, a rămas în folder și după schimbarea branch-ului. Pasul bun următor e să pui config.local.json în .gitignore, ca setările personale să nu ajungă niciodată în repository.
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
.gitignorefiș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 laUntracked 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
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: 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. The following paths are ignored by one of your .gitignore files Fișierul pe care vrei să-l adaugi se potrivește cu o regulă din .gitignore, deci Git refuză să-l pună în staging. Dacă fișierul trebuie de fapt urmărit, scoate sau corectează regula din .gitignore; dacă e o excepție, folosește git add -f fișier. Î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.
