.gitignore Oluşturucu

Bu depoda kullanılan tüm teknolojileri seçin.

İşletim sistemi ve editör kuralları genellikle genel Git dışlama dosyanızda yer almalıdır.

Sonraki: kuralları gözden geçir

Oluşturulan dosyaları, bağımlılıkları ve yerel ortam dosyalarını dışlayan bir proje .gitignore dosyası için depoda kullanılan teknolojileri seçin. Birden fazla teknoloji seçebilirsiniz. İsteğe bağlı işletim sistemi ve editör kuralları ayrı gösterilir; böylece kişisel tercihlerinizi genel Git dışlama dosyanıza ekleyebilirsiniz.

Dışlama kurallarını oluşturma ve kullanma

  1. 1

    Proje teknolojilerini seçin

    Depoda kullanılan her teknolojiyi seçin. Örneğin, ön yüz derlemesi olan bir PHP uygulaması için Laravel ve Node.js seçin.

  2. 2

    Gerekirse kişisel kuralları ekleyin

    Ayrı bir genel dışlama listesi görmek için işletim sisteminizi veya editörünüzü seçin. Mevcut genel dosyanız bunları zaten kapsıyorsa boş bırakın.

  3. 3

    Gözden geçirip kopyalayın veya indirin

    Proje kurallarını inceleyin. Kuralları deponun kök dizinindeki bir `.gitignore` dosyasına kopyalayın veya ZIP dosyasını indirip içindeki `.gitignore` dosyasını bu dizine çıkarın. İsteğe bağlı kişisel kuralları genel Git dışlama dosyanızda tutun.

  4. 4

    Commit etmeden önce kontrol edin

    Ekip arkadaşlarınızın da kullanabilmesi için proje `.gitignore` dosyasını commit edin. Özellikle örnek dosyaların ve bağımlılık kilit dosyalarının Git tarafından hâlâ görülebildiğini doğrulayın.

Hangi kural hangi dosyaya konmalı?

Kural türü Konumu Örnek
Derleme çıktıları ve kurulmuş bağımlılıklar Depoda commit edilen .gitignore node_modules/, vendor/, __pycache__/
Yerel ortam değerleri Projenin .gitignore dosyası .env ve yerel .env.* çeşitleri
Size ait işletim sistemi ve editör dosyaları Genel Git dışlama dosyası veya yalnızca bir depo için .git/info/exclude Finder meta verileri veya editör yedekleri
Ekip arkadaşlarının ihtiyaç duyduğu dosyalar Uygunsa Git takibinde tutun .env.example, package-lock.json, composer.lock, Gemfile.lock

Git, projedeki .gitignore dosyalarını, depoya özel .git/info/exclude dosyasını ve kişisel core.excludesFile ayarını okur. .gitignore commit edildiğinde proje kuralları depoyla birlikte paylaşılır. Kişisel kurallar normalde yalnızca sizin bilgisayarınızda geçerlidir. Ayrıntılar için Git ignore kılavuzuna ve GitHub’ın dosya dışlama rehberine bakın.

Örnek: Python betikleri içeren bir Node.js servisi

Node.js ve Python seçin. Proje dosyası node_modules/ gibi kurulu paketler, dist/ gibi Node derleme çıktıları ve __pycache__/ ile .venv/ gibi Python tarafından oluşturulan dosyalar için kuralları birleştirir. Yerel .env değerlerini dışlarken takip edilen bir .env.example dosyasına yer bırakır. Mac ve Visual Studio Code kullanıyorsanız kişisel seçenekleri de seçip kurallarını ayrı inceleyin. Kaydetmeden önce her iki çıktıyı gerçek deponuzla karşılaştırın.

Oluşturucu seçtiğiniz şablonları temel alır. Dosyalarınızı inceleyemez; dist/ adlı dizinin derleme çıktısı mı, commit etmek istediğiniz kaynak kod mu olduğunu bilemez. Projenize uymayan kuralları daraltın veya kaldırın. Takip edilmeyen bir dosyayı hangi kuralın etkilediğini görmek için git check-ignore -v path/to/file çalıştırın. GitHub şablon koleksiyonu teknoloji ve editörler için yararlı bir kaynaktır, ancak kendi deponuzu incelemenin yerini tutmaz.

Ortam dosyaları ve kilit dosyaları

.env dosyasını dışlamak, yerel kimlik bilgilerinin yeni commit’lere eklenmesini önlemeye yardımcı olur; daha önce commit edilmiş bir sırrı ise silmez. Sır Git geçmişindeyse dosyayı takipten çıkarın, nerelere kopyalandığını değerlendirin ve ilgili kimlik bilgisini değiştirin. Gerçek sırlar yerine yer tutucular içeren temiz bir .env.example dosyası tutun. Oluşturulan .gitignore, daha geniş .env.* deseni örnek dosyayı gizlemesin diye !.env.example istisnasını zaten içerir; kuralları düzenlerseniz bu istisnayı koruyun.

Uygulamalarda seçilen bağımlılık sürümlerinin yeniden kurulabilmesi için kilit dosyalarını commit edin. npm, package-lock.json dosyasının commit edilmesini önerir; Composer da composer.lock için aynı öneriyi yapar. Kütüphanelerin farklı kuralları olabilir; projenizin derleme ve sürüm politikasını izleyin.

Sık Sorulan Sorular

Dışlama kuralları henüz takip edilmeyen dosyaları etkiler. Yerel kopyayı koruyarak dosyayı takipten çıkarmak için git rm --cached path/to/file çalıştırın ve kaldırma değişikliğini commit edin. Dosyada kimlik bilgisi varsa onu değiştirin, Git geçmişini ve kopyaları inceleyin.

Genellikle temizlenmiş bir .env.example ile uygulama kilit dosyalarını Git takibinde tutun. Örnek dosya gereken ortam anahtarlarını gösterir; kilit dosyası ekip ve dağıtımlar için bağımlılık sürümlerini sabitler. Örnekte gerçek sır bulunmadığını kontrol edin.

Evet. Aynı depoda kullanılan tüm teknolojileri seçin. Oluşturucu seçilen proje kurallarını tek bir .gitignore dosyasında birleştirir. Projenizin farklı amaçla kullandığı yollar için sonucu gözden geçirin.

Depolar arasında geçerli olacak kişisel kurallar için genel Git dışlama dosyası kullanın. XDG_CONFIG_HOME ayarlanmamışsa Git varsayılan olarak ~/.config/git/ignore kullanır; core.excludesFile ile başka bir yol belirleyebilirsiniz. Yalnızca bu depoya özel bir kural için .git/info/exclude kullanın. Ekip istemedikçe ayrı kişisel çıktıyı paylaşılan proje dosyasına eklemeyin.

Seçtiğiniz teknolojiler ve isteğe bağlı işletim sistemi veya editör tercihleri, kuralları oluşturmak için sunucuya gönderilir. Çok adımlı akışta bu seçimler sayfanın URL adresinde de görünür. URL içine sır koymayın. Araç seçimlerden kural üretir; deponuzu okumaz veya dosyalarını yüklemez.

İlgili Araçlar

Araç diğer dillerde mevcuttur