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

The following paths are ignored by one of your .gitignore files

Pe scurt

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ă

Greșit
BASH
# .gitignore
docs/

git add docs/ghid.md
Corect
BASH
# .gitignore fără linia docs/
git add .gitignore docs/ghid.md

Linia 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

Greșit
BASH
# .gitignore
*.csv

git add date/exemplu.csv
Corect
BASH
# .gitignore
*.csv
!date/exemplu.csv

git add date/exemplu.csv

O 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

Greșit
BASH
git add -f .env
Corect
BASH
# 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ă tu

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.

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 de build, *.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 .gitignore pentru 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

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