Bir .gitignore dosyası nedir ve bunu nasıl kullanırsınız?

Question

Accepted Answer

Bir **.gitignore** dosyası Git'e hangi dosya ve dizinleri **yok sayacağını** söyler — sürüm kontrolünde takip etmez. Oluşturulan dosyaları, bağımlılıkları, sırları ve işlenmemiş olması gereken ortama özel dosyaları hariç tutmak için kullanılır.

## .gitignore ne yapar

```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 bu desenlere eşleşen dosyaları yok sayar — `git status` çıktısında görünmezler, hazırlanmazlar ve işlenmezler.

## Desen söz dizimi

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

## Ne yok sayılmalı (yaygın kategoriler)

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

## Neden önemli

`.gitignore` dosyasını anlamak **depoları temiz ve güvenli tutmak** için önemlidir, bu nedenle temel pratik Git bilgisidir.

Bir `.gitignore` dosyası **sürüm kontrolünde olmaması gereken** dosyaları hariç tutar ve bu, birkaç gerçek ihtiyacı karşılar.

**Oluşturulan/türetilen dosyaları** (derleme çıktısı, derlenmiş yapıtlar) ve **bağımlılıkları** (`node_modules`, bunlar çok büyüktür ve manifest dosyalarından yeniden yüklenir — onları işlemek depoyu şişirirdi) hariç tutarak depoyu temiz tutar — böylece depo yalnızca anlamlı kaynağı içerir.

**Ortama özel ve kişisel dosyaları** (`.DS_Store` gibi işletim sistemi artıkları, editör konfigürasyonları) hariç tutar; bu dosyalar depoyu dağınık hale getirir ve gürültü oluşturur.

En kritik olarak, **güvenlik** için gereklidir: **sırları** hariç tutmak (`.env` dosyaları, kimlik bilgileri, API anahtarları) hayati önem taşır çünkü **sırları işlemek ciddi bir güvenlik hatası**dır — bir kez işlendikten sonra, sırlar deponun geçmişinde yer alır (ve uzak/herkese açık depolara gönderildikten sonra sömürülebilecek) ve bu nedenle `.gitignore` yanlışlıkla hassas verileri işlemeye karşı kilit bir savunmadır.

**Desen söz dizimini** (dizinler, jokerler, negasyon, köke göre) anlamak etkili yok saymа kuralları yazmanızı sağlar ve **zaten takip edilen dosyaların `.gitignore` etkili olmadan önce takip dışı bırakılması** gereken (`git rm --cached`) önemli gotchasını bilmek yaygın bir kafa karışıklığını önler.

Temiz depolar (oluşturulan dosya, bağımlılık veya dağınıklık olmaksızın) ve özellikle **sırları işlememek** depo kalitesi ve güvenliği açısından önemli olduğundan ve `.gitignore` takip edilmemesi gereken dosyaları hariç tutmak için standart mekanizm olduğundan, `.gitignore` dosyasını anlamak — neyi yok sayacağını (bağımlılıklar, derleme çıktısı ve kritik olarak sırlar), desen söz dizimini ve takip dışı bırakılırken dikkat edilecek noktaları — temiz, güvenli depolar tutmak için temel ve sık kullanılan Git bilgisidir; güvenlik açısından sırları sürüm kontrolü dışında tutmak özellikle önemlidir.