Mikä on .gitignore-tiedosto ja miten sitä käytetään?

Question

Accepted Answer

A **.gitignore** tiedosto kertoo Gitille, mitkä tiedostot ja hakemistot tulee **jättää huomiotta** — ei seurata versionhallinnassa. Sitä käytetään sulkemaan pois generoidut tiedostot, riippuvuudet, salaisuudet ja ympäristökohtaiset tiedostot, joita ei pitäisi committaa.

## Mitä .gitignore tekee

```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 jättää huomiotta tiedostot, jotka vastaavat näitä malleja — ne eivät näy `git status` -komennossa, niitä ei voi staged, ja niitä ei committaa.

## Mallin syntaksi

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

## Mitä jättää huomiotta (yleiset kategoriat)

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

## Miksi se on tärkeää

Ymmärtäminen `.gitignore` on tärkeää **repositorioiden pitämiseksi puhtaina ja turvallisina**, joten se on olennainen käytännön Git-tieto.

A `.gitignore` tiedosto sulkee pois tiedostot, jotka **eivät kuulu versionhallintaan**, vastaten useisiin todellisiin tarpeisiin.

Se pitää repositoriot puhtaina sulkemalla pois **generoituja/johdettuja tiedostoja** (build-tuotokset, käännetyt artefaktit) ja **riippuvuudet** (`node_modules`, jotka ovat valtavia ja asennetaan uudelleen manifest-tiedostoista — niiden committaaminen paisuttaisi repoa) — joten repository sisältää vain merkityksellisen lähdekoodin.

Se sulkee pois **ympäristökohtaiset ja henkilökohtaiset tiedostot** (OS-jäte kuten `.DS_Store`, editorin konfiguraatiot), jotka sotkisivat repoa ja aiheuttaisivat melua.

Kritiikin tärkeintä on **turvallisuus**: sulkeminen **salaisuuksista** (`.env` tiedostot, tunnukset, API-avaimet) on elintärkeää, koska **salaisuuksien committaaminen on vakava turvallisuusvirhe** — kerran committanut, salaisuudet ovat repositorion historiassa (ja mahdollisesti pushattu remote/julkisiin repoihin, joissa ne voidaan hyödyntää), joten `.gitignore` on avainsuoja vahingossa tapahtuvan salaisien tietojen committaamisen estämiseksi.

Ymmärtäminen **mallin syntaksista** (hakemistot, jokerimerkit, negaatio, root-suhteellinen) antaa sinulle mahdollisuuden kirjoittaa tehokkaita ignore-sääntöjä, ja tietäminen tärkeästä sudenkuopasta, että **jo seuratut tiedostot on poistettava seurannasta** (`git rm --cached`) ennen kuin `.gitignore` astuu voimaan, estää yleisen sekaannuksen.

Koska puhtaat repositoriot (ei generoituja tiedostoja, riippuvuuksia tai sotku) ja erityisesti **salaisuuksien committaamatta jättäminen** ovat tärkeitä repositorion laadulle ja turvallisuudelle, ja koska `.gitignore` on vakiomekanismi tiedostojen poissulkemiseksi, joita ei pitäisi seurata, ymmärtäminen `.gitignore` — mitä jättää huomiotta (riippuvuudet, build-tuotokset ja kriittisesti salaisuudet), mallin syntaksi ja seurannasta poistamisen sudenkuoppa — on olennaista, usein käytettävää Git-tietoa puhtaiden ja turvallisten repositorioiden ylläpitämiseksi, ja salaisuuksien pitäminen poissa versionhallinnasta on erityisen tärkeää.