error: the following file has local modifications
git rm nu șterge un fișier urmărit pe care l-ai modificat și nu ai salvat modificarea, ca să nu o pierzi. Ca să-l scoți din repository dar să-l păstrezi pe disc cu modificările, rulează git rm --cached fișier; ca să-l ștergi cu tot cu modificări, git rm -f fișier.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fișierul e urmărit (există în ultimul commit), iar în working directory are modificări care nu sunt nici în staging, nici în vreun commit. git rm ar șterge fișierul de pe disc, deci și modificările tale, așa că Git se oprește: error: the following file has local modifications:, lista fișierelor și (use --cached to keep the file, or -f to force removal).
Situația cea mai des întâlnită: un fișier de configurare (setari.json, .env) a fost comis la început, apoi fiecare om din echipă l-a modificat local. Când vrei să nu-l mai urmărești, nu vrei să pierzi setările tale. Varianta --cached face exact asta: fișierul dispare din repository la următorul commit, dar rămâne la tine, cu modificările. Pune-l apoi în .gitignore, ca să nu fie adăugat din nou.
De ce apare: cauzele frecvente
1Vrei să nu mai urmărești un fișier de configurare modificat local
git rm setari.json
# error: the following file has local modificationsgit rm --cached setari.json
echo "setari.json" >> .gitignore
git add .gitignore
git commit -m "Nu mai urmăresc setari.json"--cached scoate fișierul doar din index. Fișierul de pe disc, cu modificările tale, rămâne neatins.
2Vrei să ștergi un fișier, dar ai uitat că l-ai modificat
git rm vechi.jsgit diff vechi.js # vezi ce ai schimba
git rm -f vechi.jsUită-te întâi la modificări cu git diff. Dacă nu-ți trebuie, -f confirmă că le pierzi.
Repară eroarea, direct în pagină
setari.json a fost comis la începutul proiectului, iar tu l-ai modificat local (tema dark). Echipa a decis să nu mai fie urmărit. git rm setari.json dă error: the following file has local modifications. Scoate-l din repository fără să pierzi fișierul și modificarea ta, ignoră-l și fă commit cu mesajul Nu mai urmăresc setari.json.
Indiciu
Există o opțiune a lui git rm care lucrează doar pe index.
Reparația
Vezi eroarea, apoi scoate fișierul doar din index:
git rm setari.json
git rm --cached setari.jsonIgnoră-l și fă commit-ul:
echo "setari.json" >> .gitignore
git add .gitignore
git commit -m "Nu mai urmăresc setari.json"
cat setari.jsonRezultat: fișierul nu mai e în repository, dar pe disc conține încă "tema": "dark".
De ce merge
git rm simplu ar fi șters fișierul de pe disc, cu modificarea necomisă, de aceea Git a refuzat. git rm --cached scoate fișierul doar din index: commit-ul următor îl șterge din repository, dar pe disc rămâne versiunea ta, cu tema dark. Linia din .gitignore împiedică adăugarea lui din nou.
Alte forme ale mesajului
error: the following files have local modifications:(use --cached to keep the file, or -f to force removal)
Cum o eviți pe viitor
- Nu comite de la început fișierele cu setări personale: pune în repository un exemplu (
setari.example.json) și ignoră fișierul real. - Înainte de
git rm, ruleazăgit statusșigit diffca să vezi ce ai modificat. - Reține regula:
--cachedpăstrează fișierul pe disc,-fîl șterge cu tot cu modificări.
Întrebări frecvente
După git rm --cached, colegii mei pierd fișierul?
Da, la următorul git pull fișierul le dispare din working directory, pentru că commit-ul îl șterge din repository. Anunță-i sau păstrează în repository un fișier exemplu din care își fac copia locală.
De ce nu e suficient să pun fișierul în .gitignore?
.gitignore se aplică doar fișierelor neurmărite. Un fișier deja comis rămâne urmărit până îl scoți explicit cu git rm --cached.
Erori înrudite
error: the following file has changes staged in the index git rm refuză să șteargă un fișier care are în staging o versiune încă necomisă, ca să nu pierzi acea versiune. Dacă vrei doar să-l scoți din Git și să-l păstrezi pe disc, folosește git rm --cached fișier; dacă vrei să-l ștergi de tot, git rm -f fișier. 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. fatal: not removing 'docs' recursively without -r Ai dat git rm unui folder, iar Git șterge foldere doar dacă îi ceri explicit, cu -r (recursiv). Rulează git rm -r docs (sau git rm -r --cached docs, ca să-l păstrezi pe disc) și apoi fă commit. remote: - Push cannot contain secrets GitHub a găsit în commit-urile tale o cheie, un token sau o parolă și a blocat push-ul (push protection). Scoate secretul din toate commit-urile neurcate (git rm --cached, .gitignore, commit --amend sau rebase), revocă cheia dacă a fost expusă și urcă din nou. Î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.
