.gitignore Nedir? Spring Boot için .gitignore Kuralları ve Örnekler (2026)

Devops Latest Software Developers 08/11/2023

.gitignore, Git projelerinde sürüm kontrolüne dahil edilmesini istemediğiniz dosya ve klasörleri hariç tutan uzantısız bir metin dosyasıdır. Böylece geçici dosyalar, derleme çıktıları ve hassas bilgiler (ör. .env, loglar, build çıktıları) yanlışlıkla commit edilmez.

Kısaca: .gitignore = Git’in takip etmeyeceği dosyaların listesi.

İçindekiler

.gitignore Nedir?
.gitignore Ne İşe Yarar?
.gitignore Dosyası Nasıl Oluşturulur?
Spring Boot için .gitignore Önerileri
Örnek .gitignore (Yaygın Kurallar)
Gitignore Nasıl Yazılır? (Temel Kurallar)
Commit Edilmiş Dosyayı Ignore Etmek
Global .gitignore
Bir Dosya Ignore Ediliyor mu? Kontrol Etme
Sık Sorulan Sorular (FAQ)
Sonuç

1) .gitignore Nedir?

.gitignore, Git’in hangi dosya ve klasörleri takip etmeyeceğini belirleyen dosyadır. Proje kök dizinine (root) eklenir ve Git bu kuralları otomatik olarak uygular.

Önemli: .gitignore bir “güvenlik aracı” değildir; sadece Git takibini kapatır. Eğer bir dosya daha önce commit edildiyse, ignore kuralı eklemek tek başına yeterli olmaz.

2) .gitignore Ne İşe Yarar?

Gereksiz dosyaların commit edilmesini engeller (build çıktıları, cache vb.)
Repo boyutunu küçültür ve performansı artırır
Hassas bilgilerin sızmasını önlemeye yardımcı olur (ör. .env, secrets dosyaları)
Takım içi düzen sağlar (herkes aynı kuralları kullanır)
Daha temiz ve profesyonel bir Git geçmişi oluşur

Pratik örnek: .env gibi dosyaları yanlışlıkla commit etmek ciddi güvenlik problemidir. Bu yüzden .gitignore neredeyse her projede zorunlu kabul edilir.

3) .gitignore Dosyası Nasıl Oluşturulur?

Proje ana dizinine .gitignore adında bir dosya oluşturun
İçine ignore kurallarını yazın
Git otomatik olarak bu dosyayı okur ve kuralları uygular

Linux / Mac

touch .gitignore

Windows

Proje klasöründe yeni dosya oluşturun ve adını .gitignore yapın.

4) Spring Boot için .gitignore Önerileri

Spring Boot projelerinde genellikle derleme çıktıları (target/), IDE dosyaları, loglar ve ortama özel konfigürasyonlar repoya alınmamalıdır.

Spring Boot projesi için .gitignore örneği (target, .classpath, .project ve ayar klasörleri) — Spring Boot projelerinde sık ignore edilen dosyalar: `target/`, IDE dosyaları ve proje ayarları.

Spring Boot proje kök dizininde .gitignore dosyasının konumu — `.gitignore` dosyası genellikle projenin root (ana) dizininde bulunur.

İpucu: Takım çalışmasında branch yönetimiyle birlikte temiz ignore kuralları büyük fark yaratır. Branch mantığını bilmiyorsanız şu içerik faydalı olur: Git branching nedir?

5) Örnek .gitignore Dosyası (En Yaygın Kurallar)

# Derlenmiş dosyalar
*.class

# IDE ayarları
.idea/
.vscode/
*.iml
.classpath
.project
.settings/

# Log dosyaları
*.log

# Build çıktıları (Java/Spring Boot)
target/
build/
dist/

# Ortam değişkenleri ve gizli bilgiler
.env
.env.*
secrets.yml
application-local.yml
application-dev.yml

Spring Boot notu: Ortama özel application-local.yml gibi dosyaları ignore etmek mantıklıdır. Ama takımın ihtiyacına göre “örnek config” dosyası repoya eklenebilir (aşağıdaki ! kuralına bakın).

6) Gitignore Nasıl Yazılır? (Temel Kurallar)

Kural	Açıklama
`*.log`	Tüm log dosyalarını ignore eder
`target/`	target klasörünü ignore eder (Maven build çıktısı)
`/target`	Sadece kök dizindeki target klasörünü ignore eder
`.idea/`	IntelliJ ayarlarını ignore eder
`!.env.example`	Ignore edilen listeden dosyayı geri dahil eder (çok faydalı)

Çok önemli kural: “Dahil etme” (!) kuralı sayesinde .env ignore edilirken .env.example repoya eklenebilir. Bu, ekip içi kurulum süreçlerini kolaylaştırır.

7) Commit Edilmiş Dosyayı Ignore Etmek (İleri Seviye)

Bir dosya daha önce commit edildiyse, .gitignore kuralı eklemek tek başına yetmez. Çünkü Git o dosyayı zaten takip ediyordur.

Çözüm

git rm --cached FILENAME
git commit -m "Stop tracking FILENAME"
git push

Not: Bu işlem dosyayı diskten silmez; sadece Git takibinden çıkarır.

8) Global .gitignore (Her Proje için)

Her projede tekrar tekrar aynı kuralları yazmak yerine global ignore dosyası tanımlayabilirsiniz.

git config --global core.excludesfile "~/.gitignore"

9) Bir Dosya Ignore Ediliyor mu? Kontrol Etme

Bir dosyanın hangi kural nedeniyle ignore edildiğini görmek için:

git check-ignore -v FILENAME

Git workflow’larını uygulamalı görmek isterseniz: Eclipse’de GitLab projesi alma (alıştırma) içeriği iyi bir pratik sağlar.

10) Sık Sorulan Sorular (FAQ)

.gitignore dosyası nereye konur?

Genellikle projenin root (ana) dizinine konur.

.gitignore boş kalabilir mi?

Evet, boş kalabilir. Ancak çoğu projede en azından IDE, build ve env dosyaları ignore edilir.

.gitignore ile gizli dosyalar korunur mu?

Hayır. .gitignore bir güvenlik aracı değildir. Sadece Git takibini kapatır. Eğer .env geçmişte commit edildiyse repo geçmişinde bulunabilir.

SVN yerine Git kullanmanın avantajı var mı?

Evet. Dağıtık çalışma mantığı, branch yönetimi ve workflow açısından Git güçlüdür. Detaylar için: SVN ve Git arasındaki farklar

Sonuç

.gitignore, Git projelerinde takip edilmesini istemediğiniz dosyaları hariç tutmanızı sağlayan kritik bir dosyadır. Özellikle Spring Boot projelerinde target/ gibi build çıktıları, IDE ayarları ve gizli dosyalar ignore edilerek daha temiz, daha güvenli ve daha profesyonel bir repository yönetimi sağlanır.

Repo boyutunu küçültür
Gereksiz dosyaları engeller
Takım içinde düzen sağlar
Hassas bilgilerin yanlışlıkla commit edilme riskini azaltır

Güncelleme: 2026 🚀