Git “pathspec did not match any file(s) known to git” hatası, komutta verdiğin adın Git tarafından mevcut depo bilgisi içinde eşleştirilemediğini gösterir. Bu ad bir branch adı, izlenen bir dosya yolu ya da dosya yolu deseni olabilir. Hata, bilgisayardaki ilgili dosyanın kesin olarak bulunmadığı anlamına gelmez; Git, çalıştırılan komutun bağlamında uygun bir eşleşme bulamamıştır.
Branch değiştirmeye çalışırken hata alıyorsan Git yerel branch kayıtlarında verdiğin adı bulamamış olabilir. Bir arkadaşının GitHub üzerinde yeni açtığı branch henüz senin yerel referanslarına ulaşmamışsa, doğru branch adı yazılmış olsa bile aynı mesaj görülebilir. Dosya geri alma işlemlerinde ise Git, verdiğin yolun çalışma ağacında, dizinde veya ilgili commit içinde eşleşip eşleşmediğine bakar.
Hata ne anlama gelir ve Git adı neden bulamaz?
Bu hata, Git'in komutta verilen adı mevcut depo bilgisi içinde bir branch adı veya izlenen dosya yolu olarak eşleştirememesi anlamına gelir. Teşhis için önce komutun branch işlemi mi, yoksa dosya işlemi mi yaptığını ayırmak gerekir.
Branch geçişinde en sık karşılaşılan nedenler branch adındaki yazım hatası, büyük ve küçük harflerin farklı kullanılması ve uzak depodaki yeni branch bilgisinin henüz yerel referanslara alınmamış olmasıdır. Örneğin GitHub'daki branch adı feature/giris-sayfasi iken terminalde feature/giriş-sayfasi yazmak farklı bir ad üretir. Benzer şekilde Feature/giris-sayfasi ile feature/giris-sayfasi aynı kabul edilmez.
Dosya bağlamında Git, bilgisayardaki her dosyayı genel olarak aramaz. Komutun beklediği konuma, izleme durumuna ve verilen pathspec ifadesine göre eşleşme arar. Yanlış dizinden komut çalıştırmak, dosyanın yolunu eksik yazmak veya dosyanın ilgili commit içinde bulunmaması da bu hataya neden olabilir. Git belgelerinde pathspec, dosya ve dizin kapsamını sınırlayan bir yol deseni olarak açıklanır; bu kullanım Git kullanıcı belgelerinde ayrıntılı biçimde ele alınır.
- Branch komutlarında: Branch adını karakter karakter kontrol et, büyük ve küçük harfleri karşılaştır, ardından yerel branch listesinin güncel olup olmadığını incele.
- Dosya komutlarında: Komutu doğru depo içinde ve doğru dizinden çalıştırdığını, dosya yolunun doğru olduğunu ve dosyanın Git tarafından izlenip izlenmediğini kontrol et.
Uzak branch görünmüyorsa fetch ve listeleme nasıl yapılır?

Uzak depodaki yeni branch bilgisinin yerel referanslarda görünmesi için git fetch kullanılır. GitHub'da bir arkadaşının açtığı feature/giris-sayfasi branch'ine geçmeden önce aşağıdaki akışla önce mevcut durumu görebilir, sonra yerel branch oluşturabilirsin.
$ git checkout feature/giris-sayfasi
error: pathspec 'feature/giris-sayfasi' did not match any file(s) known to git
Bu çıktı, branch adının mutlaka yanlış olduğunu kanıtlamaz. Branch uzak depoda bulunuyor, ancak senin yerel uzak referans listende henüz görünmüyor olabilir. Önce origin uzak deposundaki yeni bilgileri al:
$ git fetch origin
From github.com:ekip/uygulama
* [new branch] feature/giris-sayfasi -> origin/feature/giris-sayfasi
Ardından yerel ve uzak referansları birlikte listelemek için git branch -a komutunu çalıştır:
$ git branch -a
* main
remotes/origin/HEAD -> origin/main
remotes/origin/main
remotes/origin/feature/giris-sayfasi
main gibi satırlar yerel branch'leri, remotes/origin/ ile başlayan satırlar ise uzak takip referanslarını gösterir. Branch henüz yerelde yoksa, uzak referansı başlangıç noktası olarak kullanıp adlandırılmış bir yerel branch oluşturabilirsin:
$ git switch -c feature/giris-sayfasi --track origin/feature/giris-sayfasi
branch 'feature/giris-sayfasi' set up to track 'origin/feature/giris-sayfasi'.
Switched to a new branch 'feature/giris-sayfasi'
git switch, branch değiştirme niyetini daha açık ifade eder. git checkout ise hem branch değiştirmek hem de dosya geri yüklemek için kullanılabildiğinden, benzer görünen hata farklı bağlamlarda ortaya çıkabilir. origin/feature/giris-sayfasi uzak referansını doğrudan detached biçimde açmak yerine yerel branch'i --track ile oluşturmak, çalışmayı adlandırılmış branch üzerinde sürdürür.
Branch adını ve büyük küçük harfleri nasıl kontrol edersin?

Branch adını, git branch -a çıktısındaki yazımla birebir karşılaştırmalısın. feature/giris-sayfasi, feature/giriş-sayfasi, Feature/giris-sayfasi ve feature/giris_sayfasi farklı referans adlarıdır. Büyük küçük harf, Türkçe karakter, alt çizgi ve tire farklarını Git komutunu yazarken korumalısın.
$ git branch -a
* main
remotes/origin/feature/giris-sayfasi
remotes/origin/main
İsmi elle yeniden yazmak yerine çıktından kopyalamak, görünmeyen karakter veya harf farklarını azaltır. git fetch origin sonrasında git branch -a komutunu yeniden çalıştırarak listeyi tekrar incele. Bu işlemden sonra branch yalnızca origin/feature/giris-sayfasi biçiminde görünüyorsa, yerelde takip eden bir branch oluşturabilirsin.
$ git switch -c feature/giris-sayfasi --track origin/feature/giris-sayfasi
branch 'feature/giris-sayfasi' set up to track 'origin/feature/giris-sayfasi'.
Switched to a new branch 'feature/giris-sayfasi'
Git referans adlarını metin olarak değerlendirir. İşletim sisteminin dosya sistemi büyük küçük harfleri ayırt etmiyorsa yerel dosya karşılaştırmaları farklı davranabilir. Git, bu tür dosya sistemleriyle çalışırken core.ignoreCase ayarını kullanır; ayrıntılar için Git yapılandırma belgelerine bakabilirsin. Branch kontrolünde işletim sisteminin dosya adlarını nasıl gösterdiğine güvenmek yerine Git çıktısındaki yazımı temel al.
- Branch gerçekten
git branch -alistesinde görünüyor mu? - Yazım, büyük küçük harf ve karakterler bakımından birebir aynı mı?
- Branch yalnızca
origin/altında mı görünüyor? Öyleyse--trackile yerel branch oluştur. git fetch originsonrasında da görünmüyorsa branch adı, uzak depo veya erişim bilgilerini yeniden kontrol et.
git add hatası neden farklı bir dosya sorunudur?
git add komutundaki pathspec ifadesi branch adını değil, eklenecek dosyanın yolunu arar. Bu nedenle aynı hata metni branch değiştirme sırasında ve dosya eklerken görünse de, ikinci durumda çalışma dizinindeki dosya yolu, klasör konumu veya dosya adının yazımı incelenmelidir.
Dosya farklı bir klasördeyse göreli yol yanlış olabilir. Dosya adında boşluk varsa kabuk, adı iki ayrı argümana bölebilir:
$ git add rapor final.md
fatal: pathspec 'rapor' did not match any files
Dosyanın çalışma dizinine göre konumunu kontrol et ve adını dosya listesinden kopyala. Boşluk içeren yolları tırnak içine alarak ekle:
$ git add "rapor final.md"
$ git status --short
A rapor final.md
- Komutu çalıştırdığın klasörün depo kökü veya doğru alt klasör olduğunu kontrol et.
- Dosyanın klasör yolunu çalışma dizinine göre yaz.
- Dosya adındaki harf, boşluk ve noktalama işaretlerini kopyalayarak kullan.
- Boşluk içeren dosya ve klasör yollarını çift tırnak içine al.
git add ile ilgili pathspec davranışının kapsamı, Git'in pathspec belgelerinde açıklanır. Branch adını düzeltmek için git add kullanma; branch işlemlerinde referansı, dosya işlemlerinde ise çalışma dizinindeki yolu kontrol et.
Detached HEAD ve tekrarlanan checkout denemeleri nasıl önlenir?
Fetch yapmadan aynı checkout veya switch komutunu tekrarlamak, yerel branch bilgisini güncellemez; önce mevcut referansları ve çalışma durumunu kontrol etmelisin. GitHub'da arkadaşının açtığı feature/giris-sayfasi branch'i yerel listede görünmüyorsa, aynı komutu yeniden çalıştırmak sorunu çözmez.
origin/feature/giris-sayfasi gibi uzak referansı doğrudan checkout etmek, HEAD'in yerel bir branch yerine bir commit'e bağlanmasına ve detached HEAD durumuna düşmene yol açabilir. Kalıcı çalışma için yerel branch oluşturup uzak branch'i takip ettirmek daha güvenlidir:
git switch -c feature/giris-sayfasi --track origin/feature/giris-sayfasi
branch 'feature/giris-sayfasi' set up to track 'origin/feature/giris-sayfasi'.
Switched to a new branch 'feature/giris-sayfasi'
git switch branch değiştirme ve branch oluşturma işlemlerine odaklanır. git checkout ise branch değiştirmeye ek olarak dosya veya dizinleri belirli bir durumdan geri yükleyebilir. Bu iki kullanımın aynı komutta birleşmesi, bir adın branch mi yoksa dosya yolu mu olduğunu anlamayı zorlaştırabildiği için branch işlemlerinde git switch kullanmak teşhisi sadeleştirir. Ayrımın ayrıntıları için resmî Git switch belgelerine başvurabilirsin.
Komutları art arda denemek yerine şu teşhis akışını uygula:
- Komutu hangi amaçla çalıştırdığını belirle. Branch'e geçmek mi, yoksa bir dosya yolunu belirtmek mi istediğini ayır.
git statusile mevcut branch'i ve detached HEAD durumunu kontrol et.git branch -aile yerel ve uzak referansları listele.- Uzak branch görünmüyorsa
git fetch originçalıştır ve listeyi yeniden kontrol et. feature/giris-sayfasiadını büyük ve küçük harfleriyle birlikte GitHub'daki adla birebir karşılaştır.- Uzak referans görünüyorsa takip ilişkili yerel branch oluştur; dosya işlemi yapıyorsan dosya yolunu ve çalışma dizinini kontrol ederek komutu yeniden dene.
Sık Sorulan Sorular
git fetch yaptıktan sonra branch neden git branch -a çıktısında görünmeyebilir?
git fetch sonrasında branch görünmüyorsa branch farklı bir uzak depoda olabilir, uzak depoda bulunmayabilir, fetch kapsamına alınmamış olabilir veya adı büyük küçük harf farkıyla yazılmış olabilir. Önce git remote -v ile doğru uzak depoyu kontrol et, ardından branch adını GitHub'daki adla karşılaştır.
git switch origin/feature/giris-sayfasi komutu neden detached HEAD durumuna yol açabilir?
git switch origin/feature/giris-sayfasi komutu yerel bir branch adı oluşturmak yerine uzak referansın işaret ettiği commit'e geçebilir. Bu durumda HEAD bir branch adına bağlı kalmaz; çalışmayı sürdürmek için git switch -c feature/giris-sayfasi --track origin/feature/giris-sayfasi komutuyla yerel takip branch'i oluşturulmalıdır.
git checkout ile git switch arasında pathspec hatasını teşhis ederken hangi farklara bakılmalıdır?
git checkout hem branch hem commit hem de dosya yolu kabul edebildiği için bir adın nasıl yorumlandığını ayrıca kontrol etmek gerekir. git switch branch işlemlerine ayrıldığından dosya yolu kaynaklı pathspec sorunlarını teşhis ederken komutun gerçekten branch değiştirme amacı taşıyıp taşımadığını daha kolay anlayabilirsin.
git add komutunda dosya adındaki boşluklar pathspec hatasına nasıl yol açar?
Boşluk içeren dosya adı tırnaklanmadan yazıldığında kabuk, adı birden fazla argümana böler ve Git bu parçaları ayrı pathspec olarak değerlendirebilir. Dosya yolunu çift tırnak içine alarak veya boşlukları kaçış karakteriyle yazarak bu ayrışmayı önleyebilirsin.
Git hatalarını çözerken aynı komutu tekrarlamak yerine referansın, branch adının ve dosya yolunun hangi bağlamda değerlendirildiğini sırayla kontrol etmek daha sağlıklı bir yöntemdir.