.gitignore Nasıl Kullanılır: Örneklerle Pratik Bir Giriş

.gitignore Söz Dizimi

Belirtildiği gibi, .gitignore dosyaları, yok sayılıp sayılmayacaklarını belirlemek için deponuzdaki dosya adlarıyla eşleştirilen desenler içerir.

Temel söz dizimi

Özünde, .gitignore dosyası her biri yok sayılacak bir deseni temsil eden satırlardan oluşur. Desenler şunları eşleştirebilir:

• Belirli dosyalar
• Dosya türleri
• Dizinler 

Dosya ayrıca, # ile başlayan satırlar aracılığıyla eklenebilen yorumları ve okunabilirliği artırmak için boş satırları destekler.

İşte temel yapının bir özeti:

• Belirli bir dosyayı yok sayma: Dosyayı yok saymak için adını doğrudan listeleyebilirsiniz.

secrets.txt

• Bir dizinin tamamını yok sayma: Dizin adının sonuna bir / ekleyerek o dizinin içindeki her şeyi yok sayabilirsiniz.

logs/

• Belirli bir türdeki tüm dosyaları yok sayma: Joker karakterler (*) belirli bir uzantıya sahip tüm dosyaları yok saymak için kullanılabilir.

*.py

• Olumsuzlama: ! kullanarak bir deseni olumsuzlayabilir ve normalde yok sayılacak belirli dosya veya dizinleri açıkça izleyebilirsiniz.

*.txt  # Tüm .txt dosyalarını yok sayar
!readme.txt  # readme.txt hariç

.gitignore Dosyası Nasıl Oluşturulur ve Kullanılır

.gitignore oluşturmak ve kullanmak oldukça basittir. Bu bölümde adımları anlatacağım.

.gitignore dosyası oluşturma

Adım 1: Depo köküne gidin. .gitignore dosyası genellikle bir Git projesinin kök dizinine yerleştirilir. Terminalinizi veya komut satırınızı açın ve Git deponuzun kök dizinine gidin:

cd /path/to/your/repo

Adım 2: .gitignore dosyasını oluşturun. Kök dizindeyken, herhangi bir metin düzenleyiciyi kullanarak veya terminalde aşağıdaki gibi bir komut çalıştırarak .gitignore dosyasını oluşturun:

touch .gitignore

Adım 3: Dosyaya desenler ekleyin. .gitignore dosyasını bir metin düzenleyicide açın ve dosya veya dizinleri yok saymak için gerekli desenleri ekleyin. Her satır farklı bir deseni temsil eder.

İşte temel bir projede yaygın olarak kullanılan örnek bir .gitignore dosyası:

# node_modules ve bağımlılık dizinlerini yok say
node_modules/
vendor/

# Derleme çıktıları yok say
dist/
build/
*.log

# Sistem tarafından oluşturulan dosyaları yok say
.DS_Store
Thumbs.db

# Ortam ve gizli dosyaları yok say
.env
config.json

Gerekli desenleri ekledikten sonra dosyayı kaydedin. Git, değişiklikleri aşamalandırırken veya commit’lerken bu dosyaları otomatik olarak yok sayacaktır.

Adım 4: Dosyayı depoya commit’leyin. Tüm iş arkadaşlarının aynı yok sayma kurallarını kullanması için .gitignore dosyasını depoya commit’lemek önemlidir. Bu, projeye dahil olan herkes için tutarlılığı sağlar.

git add .gitignore
git commit -m "Add .gitignore file"
git push

.gitignore dosyası commit’lendiğinde, tüm ekip için ortak yok sayma kuralları belirlemiş olursunuz.

Git’te push ve pull işlemlerinde ustalaşmak mı istiyorsunuz? Uzaktaki depolarla çalışmanızı nasıl senkronize edeceğinizi bu Git push ve pull eğitiminde öğrenin.

.gitignore Kullanımı için En İyi Uygulamalar

Bir .gitignore dosyası oluşturmak, temiz bir Git deposu sürdürmenin basit bir parçasıdır; ancak dosyanın zaman içinde etkin şekilde yönetilmesini sağlamak için izlenmesi gereken bazı en iyi uygulamalar vardır.

Genel bir .gitignore kullanın

Birden fazla projede çalışan geliştiriciler için, proje türünden bağımsız olarak her depodan hariç tutmak isteyebileceğiniz belirli dosyalar vardır.

Bunları her projenin .gitignore dosyasına eklemek yerine, sisteminizdeki tüm depolara uygulanan genel bir .gitignore yapılandırabilirsiniz.

Genel bir .gitignore dosyasını yapılandırmak için:

• Bir .gitignore_global dosyası oluşturun:

touch ~/.gitignore_global

• Genel olarak yok saymak istediğiniz dosyalar için desenler ekleyin, örneğin:

.DS_Store
*.log
/.vscode/
/.idea/

• Git’i genel .gitignore dosyasını kullanacak şekilde ayarlayın:

git config --global core.excludesfile ~/.gitignore_global

Mevcut şablonlardan yararlanın

Her yeni proje için .gitignore dosyasını sıfırdan oluşturmak yerine, belirli dillere, framework’lere veya ortamlara yönelik önceden yapılandırılmış .gitignore şablonlarından yararlanabilirsiniz.

Bu şablonlar için en iyi kaynaklardan biri GitHub’ın resmi .gitignore deposudur; burada yüzlerce programlama dili ve framework’e uyarlanmış .gitignore dosyaları bulabilirsiniz.

.gitignore’u düzenli olarak gözden geçirin

Projeler geliştikçe, .gitignore dosyasına dahil edilmesi gereken yeni dosya ve dizinler ortaya çıkabilir. Dosyanızı belirli aralıklarla gözden geçirip güncellemeniz, projelerinizin mevcut durumunu yansıtması açısından önemlidir.

.gitignore dosyasını güncellemeniz gerekebilecek bazı durumlar şunlardır:

• Ek dosyalar üreten yeni araçlar veya kütüphaneler benimsemek (ör. yeni bir derleme sistemine geçmek).
• Dizinleri yeniden düzenlemek veya yeniden yapılandırmak; bu, hariç tutulması gereken yeni dosyalarla sonuçlanabilir.
• Artık projenin parçası olmayan eski dosya veya dizinleri kaldırmak.

.gitignore Sorun Giderme

Bir .gitignore dosyası ayarladıktan sonra bile, belirli dosyaların izlenmesi veya desenlerin beklendiği gibi çalışmaması gibi durumlarla karşılaşabilirsiniz. Bu bölümde iki yaygın sorun giderme alanını ve bunların nasıl çözüleceğini ele alacağız.

Önceden commit’lenmiş dosyaların izlenmesi 

.gitignore dosyası önceden commit’lenmiş dosyalara geriye dönük olarak uygulanmaz. 

Belirli dosyalar commit’lendikten sonra .gitignore’a bir desen eklerseniz, bu dosyalar .gitignore dosyasındaki desenle eşleşseler bile Git onları izlemeye devam edecektir.

Önceden commit’lenmiş dosyaların izlenmesini durdurmak için şu adımları izleyin:

• Dosyaları Git’in takibinden kaldırın: git rm komutunu kullanarak bunları çalışma dizininizde tutarken depodan kaldırın.

git rm --cached <file_or_directory_name>

• Değişiklikleri commit’leyin: Dosyaları Git’in takibinden kaldırdıktan sonra, bu dosyaların artık sürüm kontrol geçmişinin parçası olmaması için değişiklikleri commit’leyin.

git commit -m "Stop tracking ignored files"

• Değişiklikleri uzak depoya gönderin: Son olarak, dosyaların artık izlenmemesini sağlamak için değişiklikleri uzak depoya gönderin.

git push

Bu adımları uyguladıktan sonra Git dosyaları izlemeyi durduracaktır. Commit’lenmiş dosya çalışma dizininizde kalır ancak .gitignore desenlerinize göre gelecekteki commit’lerde yok sayılır.

Desenlerin çalıştığından emin olun 

Bazen, yok sayılmasını beklediğiniz belirli dosyaların yine de Git durumunda göründüğünü veya izlenmeye devam ettiğini fark edebilirsiniz. 

.gitignore desenlerinizin doğru çalıştığından emin olmak için şu adımları izleyin:

• Dosyalarınızın durumunu kontrol edin: Hangi dosyaların Git tarafından izlendiğini görmek için git status komutunu kullanın. Bu, yok sayılan dosyalarınızın hâlâ listelenip listelenmediğini doğrulamanıza yardımcı olur.

git status

• Desenin doğru olduğundan emin olun: .gitignore desenlerinizin sözdizimini doğru biçimlendirildiklerinden emin olmak için iki kez kontrol edin. Örneğin:
• Doğru dizin yolunu (deponun köküne göre) kullandığınızdan emin olun.
• Benzer adlara sahip tüm dosyaların izlenmesini önlemek için belirli dizinleri hedeflemek üzere bir / ekleyin.

• Önbelleği yenileyin: .gitignore dosyanızı yakın zamanda güncellediyseniz ve değişiklikler uygulanmıyorsa, Git önceki önbelleğini tutuyor olabilir. Önbelleği yenilemek için şu komutu çalıştırın:

git rm -r --cached .
git add .
git commit -m "Refresh .gitignore"

• İstisnaları kontrol edin: Bazen, .gitignore içindeki belirli bir desen dosyada başka bir daha spesifik desen tarafından geçersiz kılınabilir. Çelişen kurallar olmadığından emin olmak için kurallarınızı gözden geçirin.

Hızlı bir Git başvuru kılavuzu mu arıyorsunuz? Temel komutları parmaklarınızın ucunda tutmak için bu Git cheat sheet’ine göz atın.

Sonuç

Bir .gitignore dosyası küçük görünebilir, ancak Git deponuzu temiz ve yönetilebilir tutmada büyük bir rol oynar. Bağımlılıklar, derleme çıktıları ve sistem tarafından oluşturulan dosyalar gibi gereksiz dosyaları yok sayarak projenizin düzenli ve dağınıklıktan uzak kalmasını sağlarsınız.

Bu eğitimde bir .gitignore dosyasını nasıl oluşturacağınızı, desenler ekleyeceğinizi ve deponuzu verimli tutmak için en iyi uygulamaları nasıl hayata geçireceğinizi öğrendiniz. Bu becerilerle sürüm kontrolüyle ilgili sorunlardan kaçınacak ve ekibinizde herkes için iş birliğini daha sorunsuz hale getireceksiniz.

Git becerilerinizi derinleştirmek istiyorsanız, yapılandırılmış bir öğrenme yolu için Git Fundamentals’a göz atın. Ayrıca Foundations of Git ve Introduction to GitHub Concepts gibi uygulamalı kursları keşfederek sürüm kontrolü ve iş birliği iş akışları hakkında sağlam bir anlayış kazanabilirsiniz!