Kaj je datoteka .gitignore in kako jo uporabiš?

Question

Accepted Answer

Datoteka **.gitignore** pove Gitu, katere datoteke in direktorije naj **ignora** — jih ne sledi v kontroli verzij. Uporabljamo jo za izključitev generiranih datotek, odvisnosti, skrivnosti in datotek, specifičnih za okolje, ki jih ne smemo oddati.

## Kaj .gitignore počne

```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 ignora datoteke, ki se ujemajo s temi vzorci — ne bodo vidne v `git status`, jih ne bo mogoče pripraviti in ne bodo oddane.

## Sintaksa vzorcev

```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
```

## Kaj ignorirati (pogoste kategorije)

```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)
```

## Zakaj je to pomembno

Razumevanje `.gitignore` je pomembno za **ohranitev repozitorijev čistih in varnih**, zato je bistveno praktično znanje o Gitu.

Datoteka `.gitignore` izključi datoteke, ki **ne smejo biti v kontroli verzij**, kar rešuje več resničnih potreb.

Repo drži čistim z izključitvijo **generiranih/izvedenih datotek** (izhodov izgradnje, prevedenih artefaktov) in **odvisnosti** (`node_modules`, ki so ogromni in se ponovno namestijo iz datotek manifestov — njihovo oddajanje bi napihalo repo) — zato repozitorij vsebuje le smiselne izvorne kode.

Izključuje **datoteke specifične za okolje in osebne datoteke** (operacijski sistem smeti kot `.DS_Store`, konfiguracijske datoteke urejevalnikov), ki bi motile repo in povzročile šum.

Najbolj kritično pa je **varnost**: izključevanje **skrivnosti** (datoteke `.env`, poverilnice, ključi API) je bistveno, ker je **oddaja skrivnosti resna varnostna napaka** — ko se enkrat oddajo, so v zgodovini repozitorija (in morda potisnjene na oddaljeno/javno mesto, kjer jih je mogoče izkoristiti), zato je `.gitignore` ključna zaščita pred nenamerno oddajo občutljivih podatkov.

Razumevanje **sintakse vzorcev** (direktoriji, nadomestni znaki, negacija, relativno do korena) ti omogoči pisati učinkovita pravila ignoriranja, in znanje o pomembni napaki, da se **že spremljane datoteke morajo nehati slediti** (`git rm --cached`), preden se `.gitignore` začne uporabljati, prepreči pogosto zmedo.

Ker so čisti repozitoriji (brez generiranih datotek, odvisnosti ali neredov) in še posebej **nedodajanje skrivnosti** pomembni za kakovost repozitorija in varnost, in ker je `.gitignore` standardni mehanizem za izključitev datotek, ki jih ne smemo slediti, je razumevanje `.gitignore` — kaj ignorirati (odvisnosti, izhod izgradnje in kritično skrivnosti), sintaksa vzorcev in napaka nehote sledenja — bistveno, pogosto uporabljano Gitovo znanje za vzdrževanje čistih in varnih repozitorijev, pri čemer je varnostni vidik ohranjanja skrivnosti izven kontrole verzij še posebej pomemben.