Co je soubor .gitignore a jak jej používáte?

Question

Accepted Answer

Soubor **.gitignore** říká Gitu, které soubory a adresáře **ignorovat** — nesledovat je ve správě verzí. Používá se k vyloučení generovaných souborů, závislostí, tajemství a souborů specifických pro prostředí, které by neměly být zaslány (committed).

## Co .gitignore dělá

```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 ignoruje soubory odpovídající těmto vzorům — nezobrazí se v `git status`, nebudou připraveny k zaslání a nebudou zaslány.

## Syntaxe vzorů

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

## Co ignorovat (běžné kategorie)

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

## Proč je to důležité

Rozdělení `.gitignore` je důležité pro **udržování repozitářů čistých a bezpečných**, proto je nezbytné praktické znalosti Gitu.

Soubor `.gitignore` vyloučí soubory, které **by neměly být ve správě verzí**, a řeší několik skutečných potřeb.

Udržuje repozitáře čisté vyloučením **generovaných/odvozených souborů** (výstup sestavení, kompilované artefakty) a **závislostí** (`node_modules`, které jsou velmi velké a přeinstalovány z manifestů — jejich zaslání by zvětšilo repozitář) — takže repozitář obsahuje pouze smysluplný zdrojový kód.

Vyloučuje **soubory specifické pro prostředí a osobní** (OS nepořádek jako `.DS_Store`, konfigurace editoru), které by znečistily repozitář a způsobily šum.

Nejkritičtěji je **bezpečností**: vyloučení **tajemství** (soubory `.env`, přihlašovací údaje, klíče API) je životně důležité, protože **zaslání tajemství je vážná bezpečnostní chyba** — jakmile je zasláno, tajemství je v historii repozitáře (a potenciálně zasláno na vzdálený/veřejný repozitář, kde může být zneužito), takže `.gitignore` je klíčovou obranou proti náhodného zaslání citlivých údajů.

Pochopení **syntaxe vzorů** (adresáře, zástupné znaky, negace, relativní kořen) vám umožňuje psát účinná pravidla ignorování a znalost důležité chyby, že **již sledované soubory musí být odsledovány** (`git rm --cached`), než `.gitignore` vstoupí v platnost, zabraňuje běžné zmatkům.

Protože čisté repozitáře (bez generovaných souborů, závislostí nebo nepořádku) a zejména **nezaslání tajemství** mají importance na kvalitu repozitáře a bezpečnost a protože `.gitignore` je standardní mechanismus pro vyloučení souborů, které by neměly být sledovány, je pochopení `.gitignore` — co ignorovat (závislosti, výstup sestavení a kriticky tajemství), syntaxe vzorů a odsledování chyb — nezbytná, často používaná znalost Gitu pro údržbu čistých, bezpečných repozitářů, přičemž bezpečnostní aspekt udržování tajemství mimo správu verzí je obzvláště důležitý.