Kas yra .gitignore failas ir kaip jį naudoti?

Question

Accepted Answer

**.gitignore** failas nurodo Git, kuriuos failus ir katalogus **ignoruoti** — nesledžiant juos versijų kontrolėje. Jis naudojamas sugenertiems failams, priklausomybėms, slaptams duomenims ir aplinkai specifiniams failams, kurie neturėtų būti įkeisti, išskirti.

## Ką .gitignore daro

```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 ignoruoja failus, atitinkančius šiuos šabllonus — jie neatsiras `git status` rezultatuose, nebus parengti, ir nebus įkeisti.

## Šablono sintaksė

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

## Ką ignoruoti (dažnos kategorijos)

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

## Kodėl tai svarbu

Supratimas apie `.gitignore` yra svarbus **repozitorijų švarkumui ir saugumui išlaikyti**, todėl tai yra esminės praktinės Git žinios.

`.gitignore` failas išskiria failus, kurie **neturėtų būti versijų kontrolėje**, sprendžiant kelis realius poreikius.

Jis laiką repozitoriją švaru, išskirdamas **sugeneruotus/išvestinius failus** (paruošos rezultatus, kompiliuotus artefaktus) ir **priklausomybes** (`node_modules`, kurie yra dideli ir iš naujo suinstaliuojami iš manifestų failų — jų įkeitimas padidintų repozitorijos dydį) — todėl repozitoryje lieka tik prasminga šaltinio kodu.

Jis išskiria **aplinkai specifinės ir asmenines failus** (OS šiukšles, pavyzdžiui `.DS_Store`, redaktoriaus konfigūracijas), kurie užtemdytų repozitorijos ir sukeltų trukdžius.

Svarbiausiai, tai yra esminis **saugumui**: **slaptų duomenų** (`.env` failai, kredencialai, API raktai) išskyrus yra kritiškas, nes **slaptų duomenų įkeitimas yra rimta saugumo klaida** — kartą įkeitę, slaptieji duomenys yra repozitorijos istorijoje (ir potencialiai ištisinti į nuotolinę/viešą repozitoriją, kur jie gali būti panaudoti), todėl `.gitignore` yra pagrindinė gynyba prieš atsitiktinį jautrių duomenų įkeitimą.

Supratimas apie **šablono sintaksę** (katalogus, šiluetus, neigimą, šaknies santykines kelius) leidžia parašyti veiksmingus ignoravimo taisykles, o žinojimas apie svarbią pastabą, kad **jau sekiami failai turi būti atsekti** (`git rm --cached`), prieš `.gitignore` į jėgą, išvengti dažno nedažnumo.

Kadangi švarios repozitorijos (be sugeneruotų failų, priklausomybių ar netvarkos) ir ypač **nešaltinių slaptų duomenų** versijų kontrolėje yra svarbios repozitorijos kokybei ir saugumui, o `.gitignore` yra standartinis mechanizmas failams, kurie neturėtų būti sekiami, išskirti, supratimas apie `.gitignore` — ką ignoruoti (priklausomybės, paruošos rezultatus ir kritiškai slaptieji duomenys), šablono sintaksę ir atsekimo nedažnumą — yra esminės, dažnai taikomos Git žinios švarioms, saugoms repozitorijoms išlaikyti, o saugumo aspektas, kad slaptieji duomenys būtų išskirti iš versijų kontrolės, yra ypač svarbus.