VS Code Python Bulunamadı Hatası: Doğru Yorumlayıcıyı Seçme

VS Code Python Bulunamadı Hatası: Doğru Yorumlayıcıyı Seçme
1

VS Code’da ilk Python dosyanızı çalıştırmak istediniz ve “Python bulunamadı” ya da “Select a Python interpreter” uyarısıyla karşılaştınız. VSCode Python bulunamadı hatası genellikle Python eklentisinin, Python’ın kendisini kurduğunu sanmaktan kaynaklanır; eklenti yalnızca bilgisayardaki Python’ı kullanır. Önce Python’ın kurulu olduğunu terminalde doğrulayıp ardından VS Code’da doğru yorumlayıcıyı seçmeniz gerekir.

Kısa cevap

Ctrl + Shift + P ile Komut Paleti’ni açın, Python: Select Interpreter yazın ve projenizin .venv ortamını veya kurulu Python sürümünü seçin. Liste boşsa Python’ı python.org üzerinden kurun, VS Code’u kapatıp yeniden açın ve Microsoft’un Python eklentisinin etkin olduğunu doğrulayın.

VSCode Python bulunamadı sorununu gösteren yorumlayıcı ekranı

VSCode Python neden bulunamadı?

Python eklentisi etkin olsa bile sistemde bir Python yorumlayıcısı bulunmayabilir. Yorumlayıcı standart dışı klasöre kurulmuş, proje için yanlış ortam seçilmiş, sanal ortam bozulmuş veya ortam keşif önbelleği güncel olmayabilir. WSL, Dev Container ve uzak SSH pencereleri kendi çalışma ortamlarındaki Python kurulumunu kullanır.

  • python --version ve gerekirse py --version ile Windows terminalinde kurulumu kontrol edin.
  • Durum çubuğunda seçili Python sürümünü ve yolunu inceleyin.
  • Proje kökündeki .venv klasörünün eksik veya bozuk olmadığını doğrulayın.
  • Uzak pencerede yerel bilgisayarın Python’ının otomatik kullanılamayacağını unutmayın.

VSCode Python bulunamadı hatası nasıl çözülür?

1. Python yorumlayıcısını doğrulayın

VS Code terminalinde python --version çalıştırın. Windows’ta komut bulunamazsa py --version da deneyin. İkisi de başarısızsa Python’ı resmî python.org sitesinden kurun. Kurulum ekranındaki PATH seçeneğini okuyun; ardından bütün terminalleri ve VS Code’u yeniden başlatın.

2. Microsoft Python eklentisini kurun

Eklentiler görünümünde yayıncısı Microsoft olan Python eklentisini bulun, kurun ve etkinleştirin. Benzer adlı üçüncü taraf eklentiler yorumlayıcı seçimini sağlamayabilir. Güvenilmeyen bir çalışma alanındaysanız bazı özellikler sınırlı olabilir; yalnızca kaynağını bildiğiniz projelere güvenin.

3. Doğru yorumlayıcıyı seçin

Ctrl + Shift + P → Python: Select Interpreter yolunu açın. Projeye ait .venv, Conda veya sistem yorumlayıcısını seçin. Yorumlayıcı görünmüyorsa Enter interpreter path seçeneğiyle Python çalıştırılabilir dosyasını elle gösterin. Rastgele bir python.exe seçmek yerine projenin bağımlılıklarının kurulu olduğu ortamı kullanın.

VS Code sanal ortamı görmüyor

Microsoft’un güncel ortam belgelerine göre VS Code çalışma alanında .venv ve venv gibi yerel ortamları öncelikli keşfeder. Yeni oluşturulan ortam görünmüyorsa Python Environments görünümünde Refresh All Environment Managers komutunu çalıştırın. Özel konumdaki ortamlar için çalışma alanı arama yollarını yapılandırın.

4. Bozuk sanal ortamı yeniden oluşturun

Ortam “broken” görünüyorsa pyvenv.cfg veya Python çalıştırılabilir dosyası eksik olabilir. Önce bağımlılık listenizin requirements.txt veya pyproject.toml içinde bulunduğunu doğrulayın. Eski ortamı silmeden önce gerekli dosyaları kaydedin; ardından python -m venv .venv ile yeni ortam oluşturup yorumlayıcıyı yeniden seçin.

5. Yeni terminal açın

Yorumlayıcı seçildikten sonra mevcut terminal eski ortamda kalabilir. Terminali kapatıp Terminal → New Terminal ile yenisini açın. Komut satırının başında ortam adı görünmesini ve python -c "import sys; print(sys.executable)" çıktısının seçtiğiniz yola karşılık gelmesini kontrol edin.

VSCode Python bulunamadı sorununun düzeldiğini basit bir print("test") dosyasını Run Python File in Terminal ile çalıştırarak doğrulayın. Paket bulunamıyorsa aynı ortamda python -m pip kullanın; düz pip komutu başka Python kurulumuna paket yükleyebilir.

Terminal ile VS Code farklı Python kullanıyorsa

VSCode Python bulunamadı uyarısı giderildiği hâlde terminal farklı sürüm gösteriyorsa önce seçili yorumlayıcının tam yolunu not edin. Yeni terminalde python -c "import sys; print(sys.executable)" çalıştırıp iki yolu karşılaştırın. PowerShell veya Komut İstemi’ni VS Code yorumlayıcı seçilmeden önce açtıysanız ortam etkinleştirmesi eski terminale uygulanmayabilir. Terminali kapatıp yenisini oluşturun; gerekirse çalışma alanını yeniden yükleyin. Proje klasörünü tek başına açmak, üst klasördeki başka ayarların seçimi değiştirmesini önleyebilir. Python çalışıp yalnızca Git işlemleri başarısızsa sorun yorumlayıcı değildir; GitHub authentication failed rehberindeki kimlik doğrulama kontrollerine geçin.

Belirtiye göre nereden başlamalı?

Gördüğünüz durumİlk yapmanız gereken
Terminalde python çalışıyor ama VS Code görmüyorCtrl+Shift+P → “Python: Select Interpreter” ile doğru yorumlayıcıyı elle seçin.
Komut Microsoft Store’u açıyorWindows’taki uygulama yürütme takma adları gerçek Python’un önüne geçiyor; Ayarlar’dan python.exe takma adını kapatın.
Sanal ortam listede çıkmıyorOrtam klasörü proje kökünde değilse VS Code otomatik bulmaz; yorumlayıcı yolunu elle gösterin.
Eklenti hiç yüklenmiyorMicrosoft’un Python eklentisini kaldırıp yeniden kurun, ardından pencereyi yeniden yükleyin.

Sık yapılan hatalar

  • Python’u kurarken “Add python.exe to PATH” seçeneğini işaretlememek ve sorunu VS Code’da aramak.
  • Yeni kurulumdan sonra açık kalan eski terminalde denemek; PATH değişikliği yalnızca yeni açılan terminallerde geçerli olur.
  • Projeyi başka bilgisayardan kopyalarken içindeki sanal ortam klasörünü de taşımak; kopyalanan ortam çoğu zaman çalışmaz, yeniden oluşturulmalıdır.

Sık sorulan sorular

Python eklentisini kurmak Python’ı da kurar mı?

Hayır. Microsoft’un resmî VS Code belgesine göre Python yorumlayıcısını ayrıca kurmanız ve ardından VS Code’da seçmeniz gerekir.


Kaynaklar: VS Code’da Python ve Python Ortamları. Bilgiler 10 Ağustos 2026 tarihinde kontrol edildi.

Bu Yazıya Tepkiniz Ne Oldu?
  • be_endim
    Beğendim
    0
  • alk_l_yorum
    Alkışlıyorum
    0
  • e_lendim
    Eğlendim
    0
  • d_nceliyim
    Düşünceliyim
    0
  • _rendim
    İğrendim
    0
  • _z_ld_m
    Üzüldüm
    0
  • _ok_k_zd_m
    Çok Kızdım
    0
3955 Puan

Kadir Yılmaz, TeknoSatır'ın kurucusu ve editörü. Windows hataları, hesap güvenliği, internet bağlantı sorunları ve günlük kullanılan uygulamalardaki aksaklıklar üzerine çözüm rehberleri hazırlıyor. Rehberlerde Microsoft, Google ve Apple gibi üreticilerin resmi destek sayfalarını kaynak alıyor; adımları sade bir dille, hangi durumda işe yarayıp hangi durumda yaramayacaklarını belirterek anlatıyor. TeknoSatır'ın YouTube kanalında kısa çözüm videoları da paylaşıyor.

Bültenimize Katılın

Hemen ücretsiz üye olun ve yeni güncellemelerden haberdar olan ilk kişi olun.

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

Yorumlar (1)

    Bir yanıt yazın

    E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir