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

error: the following file has changes staged in the index

Pe scurt

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

Greșit
BASH
git add .
git rm config.local
# error: the following file has changes staged in the index
Corect
BASH
git rm --cached config.local
echo "config.local" >> .gitignore

Fiș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

Greșit
BASH
echo "v2" >> note.txt
git add note.txt
git rm note.txt
Corect
BASH
git 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

Greșit
BASH
git rm app.js   # voiai doar să anulezi git add
Corect
BASH
git restore --staged app.js

Pentru 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ă tu

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.

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 status ce ai în staging înainte de git 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 -f doar 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

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