...
Eroare Git · Repository, staging și commit

error: the following file has local modifications

Pe scurt

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

Greșit
BASH
git rm setari.json
# error: the following file has local modifications
Corect
BASH
git 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

Greșit
BASH
git rm vechi.js
Corect
BASH
git diff vechi.js   # vezi ce ai schimba
git rm -f vechi.js

Uită-te întâi la modificări cu git diff. Dacă nu-ți trebuie, -f confirmă că le pierzi.

Repară tu

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.

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 și git diff ca să vezi ce ai modificat.
  • Reține regula: --cached pă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

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