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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
git rm fișier face două lucruri: scoate fișierul din index (staging) și îl șterge de pe disc. Înainte, Git verifică dacă nu cumva ai pierde ceva: dacă versiunea din staging diferă de cea din ultimul commit (de exemplu ai rulat git add pe un fișier nou sau pe o modificare), acea versiune nu e salvată nicăieri altundeva. De aceea se oprește cu error: the following file has changes staged in the index:, urmat de lista fișierelor și de sugestia (use --cached to keep the file, or -f to force removal).
Cele două ieșiri din mesaj fac lucruri foarte diferite. --cached scoate fișierul doar din index și din urmărire, iar fișierul rămâne pe disc, neatins. -f (force) îl șterge și din index, și de pe disc, deci conținutul se pierde. Situația tipică: ai adăugat din greșeală un fișier cu setări locale sau parole și vrei să nu ajungă în commit.
De ce apare: cauzele frecvente
1Ai adăugat din greșeală un fișier nou și vrei să-l scoți din staging
git add .
git rm config.local
# error: the following file has changes staged in the indexgit rm --cached config.local
echo "config.local" >> .gitignoreFișierul nou există doar în staging și pe disc, nu și în vreun commit. --cached îl scoate din staging și îl lasă pe disc; .gitignore îl ține în afara următoarelor git add ..
2Ai modificat și ai adăugat un fișier, apoi vrei să-l ștergi
echo "v2" >> note.txt
git add note.txt
git rm note.txtgit rm -f note.txt
git commit -m "Șterg note.txt"Versiunea v2 e doar în staging. Dacă ești sigur că nu-ți mai trebuie, -f confirmă ștergerea; altfel, fă întâi commit sau copiază fișierul.
3Confunzi git rm cu scoaterea din staging
git rm app.js # voiai doar să anulezi git addgit restore --staged app.jsPentru a anula un git add pe un fișier pe care îl păstrezi în proiect, git restore --staged e comanda potrivită. git rm înseamnă „scoate fișierul din proiect”.
Repară eroarea, direct în pagină
Ai rulat git add . și a intrat în staging și config.local, cu setările tale locale. git rm config.local dă error: the following file has changes staged in the index. Scoate fișierul din Git fără să-l ștergi de pe disc, adaugă-l în .gitignore și fă un commit cu mesajul Ignor config.local.
Indiciu
Mesajul îți dă chiar opțiunea care păstrează fișierul pe disc.
Reparația
Vezi eroarea, apoi scoate fișierul doar din index:
git rm config.local
git rm --cached config.localIgnoră-l și salvează regula:
echo "config.local" >> .gitignore
git add .gitignore
git commit -m "Ignor config.local"
git statusRezultat: config.local e încă pe disc, dar nu mai apare în git status și nu e în commit.
De ce merge
config.local era doar în staging, deci git rm simplu l-ar fi șters de pe disc fără ca acea versiune să existe în vreun commit, iar Git a refuzat. git rm --cached îl scoate doar din index, iar fișierul rămâne pe disc. Linia din .gitignore face ca git add . să-l sară de acum înainte, iar commit-ul salvează regula pentru toată echipa.
Alte forme ale mesajului
error: the following files have changes staged in the index:(use --cached to keep the file, or -f to force removal)
Cum o eviți pe viitor
- Verifică cu
git statusce ai în staging înainte degit rm. - Pentru un fișier care nu trebuie urmărit:
git rm --cached fișierși o linie în.gitignore. - Pentru a anula doar un
git add:git restore --staged fișier. - Folosește
-fdoar când ești sigur că nu mai ai nevoie de conținut: ce era doar în staging nu se mai poate recupera ușor.
Întrebări frecvente
Ce diferență e între git rm --cached și git restore --staged?
git restore --staged doar anulează git add: fișierul rămâne urmărit, cu versiunea din ultimul commit. git rm --cached îl scoate complet din urmărire: la următorul commit, fișierul dispare din repository, dar rămâne pe discul tău.
Pierd ceva dacă folosesc --cached?
Nu. Fișierul de pe disc rămâne exact cum era. Se schimbă doar faptul că Git nu-l mai urmărește.
Erori înrudite
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. 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: pathspec 'stil.css' did not match any files git add nu găsește niciun fișier cu numele sau calea pe care ai scris-o. Verifică numele exact cu ls sau git status (inclusiv folderul și literele mari) și rulează git add cu calea corectă, de exemplu git add css/stil.css. Î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.
