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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
.gitignore conține tipare de fișiere pe care Git nu trebuie să le urmărească: node_modules/, *.log, .env, foldere de build. Când rulezi explicit git add pe un fișier care se potrivește cu un astfel de tipar, Git nu îl adaugă și afișează lista căilor ignorate, cu sugestia Use -f if you really want to add them.
De cele mai multe ori, mesajul te protejează (nu vrei să urci parola din .env). Uneori însă regula e prea largă: docs/ ignoră tot folderul de documentație, *.json ignoră și package.json. Rulează git check-ignore -v fișier: îți spune exact ce fișier .gitignore și ce linie îl ignoră. Repari regula, nu forțezi, dacă fișierul trebuie urmărit permanent.
De ce apare: cauzele frecvente
1O regulă din .gitignore e prea largă
# .gitignore
docs/
git add docs/ghid.md# .gitignore fără linia docs/
git add .gitignore docs/ghid.mdLinia docs/ ignoră tot folderul. După ce o scoți, fișierele din el pot fi adăugate normal.
2Vrei o excepție de la un tipar general
# .gitignore
*.csv
git add date/exemplu.csv# .gitignore
*.csv
!date/exemplu.csv
git add date/exemplu.csvO linie care începe cu ! face o excepție de la tiparul de deasupra, deci fișierul anume poate fi urmărit.
3Fișierul chiar nu trebuie urcat
git add -f .env# lasă .env ignorat și urcă un model fără secrete
git add .env.example-f ocolește protecția. Pentru fișiere cu parole, soluția corectă e să rămână ignorate.
Repară eroarea, direct în pagină
Ai scris ghidul de instalare în docs/ghid.md, dar git add docs/ghid.md răspunde The following paths are ignored by one of your .gitignore files. Cineva a pus din greșeală docs/ în .gitignore. Corectează .gitignore (păstrează regula pentru node_modules/) și salvează ghidul în commit.
Indiciu
Scoate din .gitignore linia care ignoră folderul docs, apoi adaugă ambele fișiere.
Reparația
Vezi mesajul și regulile din .gitignore:
git add docs/ghid.md
cat .gitignoreRescrie .gitignore fără linia docs/ (sau șterge-o din editor, cu nano .gitignore):
printf "node_modules/\n" > .gitignoreAdaugă regulile corectate și ghidul, apoi fă commit-ul:
git add .gitignore docs/ghid.md
git commit -m "Adaugă ghidul de instalare"Rezultat: ghidul e în commit, iar node_modules/ rămâne ignorat.
De ce merge
Regula docs/ făcea ca tot folderul de documentație să fie ignorat, iar Git refuză să adauge fișiere ignorate fără -f. Ghidul trebuie urmărit permanent, deci reparația corectă e regula, nu forțarea: după ce linia dispare din .gitignore, docs/ghid.md e un fișier nou obișnuit. Modificarea din .gitignore intră și ea în commit, ca restul echipei să primească aceeași regulă.
Alte forme ale mesajului
hint: Use -f if you really want to add them.
Cum o eviți pe viitor
- Scrie tipare cât mai precise în
.gitignore(/build/în loc debuild,*.logîn loc de*.*). - Folosește excepții cu
!pentru fișierele care trebuie urmărite. - Verifică o regulă cu
git check-ignore -v cale/fișierînainte să o schimbi. - Pornește de la șabloanele oficiale de
.gitignorepentru limbajul tău, nu de la liste copiate la întâmplare.
Întrebări frecvente
Am adăugat un fișier în .gitignore, dar Git încă îl urmărește. De ce?
.gitignore afectează doar fișierele neurmărite. Pentru unul deja comis, rulează git rm --cached fișier și fă commit; de atunci regula se aplică.
Dacă folosesc git add -f, fișierul rămâne urmărit?
Da. Odată adăugat, Git îl urmărește normal, chiar dacă tiparul din .gitignore se potrivește în continuare.
Erori înrudite
nothing to commit, working tree clean Git nu vede nicio modificare față de ultimul commit, deci nu are ce salva. Verifică dacă ai salvat fișierul în editor, dacă lucrezi în folderul repository-ului și dacă modificarea nu e deja în ultimul commit (git log -p -1). 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. nothing added to commit but untracked files present (use "git add" to track) Ai fișiere noi în proiect, dar niciunul nu e în staging, deci commit-ul nu are ce salva. Adaugă-le cu git add nume-fișier (sau git add . pentru toate), apoi rulează din nou git commit. Î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.
