Ce este un fișier .gitignore și cum îl utilizezi?

Question

Accepted Answer

Un fișier **.gitignore** spune Git-ului care fișiere și directoare să **ignore** — să nu le urmărească în controlul versiunilor. Este folosit pentru a exclude fișierele generate, dependențele, secretele și fișierele specifice mediului care nu ar trebui să fie comise.

## Ce face .gitignore

```text
# .gitignore — patterns of files Git should NOT track
node_modules/          # dependencies (reinstalled from package files, don't commit)
dist/                  # build output (generated, don't commit)
*.log                  # log files
.env                   # ⚠️ SECRETS / environment variables — NEVER commit!
.DS_Store              # OS-specific junk
.vscode/               # editor config (often personal)
build/
coverage/
*.tmp
```

Git ignoră fișierele care se potrivesc acestor modele — nu vor apărea în `git status`, nu vor fi pregătite și nu vor fi comise.

## Sintaxa modelelor

```text
node_modules/    → ignore a directory (and everything in it)
*.log            → ignore all files with a .log extension
!important.log   → EXCEPTION: do NOT ignore this (negation)
/build           → ignore "build" only in the root (leading slash = root-relative)
doc/*.txt        → .txt files in doc/ but not subdirectories
**/temp          → "temp" anywhere in the tree
```

## Ce să ignori (categorii comune)

```text
✓ DEPENDENCIES — node_modules/, vendor/ (reinstalled from manifests; huge, don't commit)
✓ BUILD OUTPUT — dist/, build/, *.o (generated from source)
✓ SECRETS — .env, credentials, keys (⚠️ NEVER commit secrets — a serious security issue)
✓ ENVIRONMENT/OS/EDITOR files — .DS_Store, .idea/, .vscode/ (personal/machine-specific)
✓ LOGS, caches, temp files
```

```text
⚠️ Already-tracked files aren't ignored by adding them later — untrack first:
   git rm --cached <file>   (then commit; .gitignore prevents re-adding)
```

## De ce contează

Înțelegerea `.gitignore` este importantă pentru **păstrarea depozitelor curate și sigure**, deci este o cunoaștere Git practică esențială.

Un fișier `.gitignore` exclude fișierele care **nu ar trebui să fie în controlul versiunilor**, răspunzând la mai multe nevoi reale.

Pastrează depozitele curate excludând **fișiere generate/derivate** (output-ul de build, artefactele compilate) și **dependențe** (`node_modules`, care sunt enorme și reinstalate din fișierele manifest — comiterea lor ar umfla depozitul) — astfel depozitul conține doar codul sursă semnificativ.

Exclude **fișierele specifice mediului și personale** (gunoi OS ca `.DS_Store`, configurări de editor) care ar aglomera depozitul și ar cauza zgomot.

Cel mai critic, este esențial pentru **securitate**: excluderea **secretelor** (fișiere `.env`, credențiale, chei API) este vitală deoarece **comiterea secretelor este o greșeală de securitate serioasă** — odată comise, secretele sunt în istoricul depozitului (și potențial trimise la depozite remote/publice unde pot fi exploatate), deci `.gitignore` este o apărare cheie împotriva comiterii accidentale a datelor sensibile.

Înțelegerea **sintaxei modelelor** (directoare, wildcard-uri, negație, relativ la rădăcină) te permite să scrii reguli de ignorare eficiente, iar cunoașterea gotchei importantă că **fișierele deja urmărite trebuie să fie neînscrise** (`git rm --cached`) înainte ca `.gitignore` să intre în vigoare previne o confuzie comună.

Deoarece depozitele curate (fără fișiere generate, dependențe sau aglomeration) și în special **să nu comitem secretele** contează pentru calitatea și securitatea depozitului, și deoarece `.gitignore` este mecanismul standard pentru excluderea fișierelor care nu ar trebui să fie urmărite, înțelegerea `.gitignore` — ce să ignori (dependențe, output de build și în mod critic secretele), sintaxa modelelor și gotcha-ul neînscrierii — este o cunoaștere Git esențială, frecvent aplicată pentru menținerea depozitelor curate și sigure, cu aspectul securității de a ține secretele din controlul versiunilor fiind deosebit de important.