Što je .gitignore datoteka i kako se koristi?

Question

Accepted Answer

Datoteka **.gitignore** govori Gitu koje datoteke i direktorije da **ignora** — nisu praćene u kontroli verzija. Koristi se za isključivanje generiranih datoteka, zavisnosti, tajnih podataka i datoteka specifičnih za okruženje koje ne bi trebalo biti učvršćeno.

## Što .gitignore radi

```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 koje odgovaraju tim uzorcima — neće se pojaviti u `git status`, neće biti pripremljene i neće biti učvršćene.

## Sintaksa uzoraka

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

## Što ignora (česte 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)
```

## Zašto je važno

Razumijevanje `.gitignore` je važno za **čuvanje repozitorija čistim i sigurnim**, pa je to bitno praktično znanje o Gitu.

Datoteka `.gitignore` isključuje datoteke koje **ne bi trebalo biti u kontroli verzija**, rješavajući nekoliko stvarnih potreba.

Cuva repozitorij čistim isključivanjem **generiranih/izvedenih datoteka** (izlaz izgradnje, kompajlirani artefakti) i **zavisnosti** (`node_modules`, koje su ogromne i reinstalirane iz datoteka manifesta — učvršćivanje njih bi napuhalo repozitorij) — pa repozitorij sadrži samo važan izvorni kod.

Isključuje **datoteke specifične za okruženje i osobne datoteke** (gnjida OS-a poput `.DS_Store`, konfiguracije editora) koje bi zagadile repozitorij i izazvale buku.

Najvažnije, neophodno je za **sigurnost**: isključivanje **tajnih podataka** (`.env` datoteke, vjerodajnice, API ključevi) je vitalno jer je **učvršćivanje tajnih podataka ozbiljna sigurnosna greška** — nakon što su učvršćeni, tajni podaci su u povijesti repozitorija (i potencijalno gurnutih na udaljene/javne repozitorije gdje mogu biti iskorišteni), pa je `.gitignore` ključna obrana od slučajnog učvršćivanja osjetljivih podataka.

Razumijevanje **sintakse uzoraka** (direktoriji, zamjenski znakovi, negacija, relativno na korijen) omogućava vam pisanje učinkovitih pravila ignora, a znanje o važnom opasnom mjestu da **već praćene datoteke moraju biti nepraćene** (`git rm --cached`) prije nego što `.gitignore` počne vrijediti sprječava čest nesporazum.

Budući da čisti repozitoriji (bez generiranih datoteka, zavisnosti ili gnjide) i posebno **ne učvršćivanje tajnih podataka** materijalno utječu na kvalitetu i sigurnost repozitorija, i budući da je `.gitignore` standardan mehanizam za isključivanje datoteka koje ne bi trebalo biti praćene, razumijevanje `.gitignore` — što ignora (zavisnosti, izlaz izgradnje i kritično tajne podatke), sintaksu uzoraka i opasno mjesto s nepraćenjem — je bitno, često primijenjeno znanje o Gitu za održavanje čistih, sigurnih repozitorija, pri čemu je sigurnosni aspekt čuvanja tajnih podataka izvan kontrole verzija posebno važan.