.gitignore dosyası nedir?

.gitignore dosyası, Git'e hangi dosyaları sürüm kontrolü dışında tutacağını söyler: yeniden yükleyebileceğiniz bağımlılıklar (node_modules gibi), derleme çıktıları, günlükler, cache'ler, editör ayarları ve macOS'taki .DS_Store ya da Windows'taki Thumbs.db gibi işletim sisteminizin oluşturduğu dosyalar. Dosyayı deponuzun kök klasörüne koyun. İçindeki kalıplar bu klasör ve altındaki tüm klasörler için geçerlidir.

Şablonlar nereden geliyor?

Şablonlar, GitHub'ın resmi koleksiyonu olan github/gitignore deposundan alınmıştır; GitHub, depo oluştururken aynı şablonları sunar. Araç, her gün yenilenen bir kopyayı yükler. Şablonlar üç gruba ayrılır:

  • Ana şablonlar; Node, Python, Java, Go, Rust, Unity ve WordPress gibi diller, çerçeveler ve araçlar içindir.
  • Genel şablonlar; macOS, Windows, Linux, VisualStudioCode, JetBrains ve Vim gibi editörler, işletim sistemleri ve diğer araçlar içindir. Bunlar hem projenizin .gitignore dosyası hem de Git'in tüm depolarınıza uygulayabileceği genel .gitignore dosyası için uygundur.
  • Topluluk şablonları; JavaScript/Vue veya Python/JupyterNotebooks gibi, topluluk tarafından sürdürülen daha özel çerçeveler ve araçlar içindir.

Nasıl kullanılır?

  1. Popüler bir proje türü için hızlı seçimle başlayın. Bu seçim, kullanılan teknoloji yığınının şablonlarının yanı sıra macOS, Windows ve genellikle bu teknoloji yığınıyla birlikte kullanılan editörün şablonlarını da seçer.
  2. Ya da Şablonlar alanında arama yapıp projenizin kullandığı tüm dilleri, çerçeveleri, editörleri ve işletim sistemlerini seçin. Bir şablonu kaldırmak için işaretini kaldırın veya alanda Backspace tuşuna basın.
  3. Seçim yaptıkça .gitignore dosyası oluşturulur; her şablon, seçtiğiniz sırayla kendi başlık yorumunun altında yer alır.
  4. Dosyayı kopyalayın ya da indirip deponuzun kök klasörüne .gitignore adıyla kaydedin. Tarayıcılar adı noktayla başlayan dosyaları kaydetmediğinden, dosya gitignore.txt veya gitignore adıyla indirilir: dosyanın adını .gitignore olarak değiştirin.

İpuçları

  • Node ve Nextjs şablonlarındaki node_modules/ gibi kalıplar iki şablonda da bulunabilir. Bir kalıbın tekrarlanması sorun oluşturmaz.
  • Bir kalıp, Git'in zaten izlediği bir dosyanın izlenmesini durdurmaz. Dosyayı diskte tutup izlenmesini durdurmak için git rm --cached komutunu, ardından dosyanın yolunu çalıştırın ve sonra commit edin.
  • ! ile başlayan bir satır, önceki bir kalıbın hariç tuttuğu dosyaları yeniden dahil eder. VisualStudioCode şablonu, .vscode/settings.json gibi paylaşılan ayarları depoda tutmak için bu yöntemi kullanır.

Özellikler

  • GitHub'ın her gün yenilenen resmi .gitignore şablonları
  • Diller, çerçeveler, editörler ve işletim sistemleri tek bir aranabilir listede
  • Popüler proje türleri için hızlı seçimler
  • Her şablon kendi başlığı altında
  • Dosyayı kopyalama veya indirme imkânı