VS Code Python’u Görmüyor: Deneyebileceğiniz 6 Çözüm

Visual Studio Code’da Python dosyası açtığınız halde yorumlayıcı görünmüyor, kod çalışmıyor veya “Select Interpreter” bölümünde Python çıkmıyorsa sorun genellikle kurulum, PATH ayarı ya da yanlış yorumlayıcı seçiminden kaynaklanır.

Bu rehberde VS Code’un Python’u görmemesi durumunda kontrol edebileceğiniz 6 pratik çözümü adım adım ele alıyoruz.

1. Python’un Bilgisayarınızda Kurulu Olduğunu Kontrol Edin

İlk olarak Python’un gerçekten Windows’a kurulmuş olduğundan emin olun.

Windows Terminal, PowerShell veya Komut İstemi’ni açıp şu komutu yazın:

python --version

Eğer sürüm bilgisi görünmüyorsa şu komutu da deneyin:

py --version

Örneğin şu şekilde bir çıktı görüyorsanız Python kuruludur:

Python 3.x.x

Her iki komut da çalışmıyorsa önce Python kurulumunu tamamlamanız gerekir.

2. VS Code’da Doğru Python Yorumlayıcısını Seçin

Python bilgisayarınızda kurulu olsa bile Visual Studio Code bazen doğru yorumlayıcıyı otomatik olarak seçmeyebilir.

VS Code içinde komut paletini açın:

Ctrl + Shift + P

Arama alanına şunu yazın:

Python: Select Interpreter

Listeden bilgisayarınızda kurulu Python sürümünü seçin.

Eğer birden fazla Python sürümü varsa, projenizde kullanmak istediğiniz sürümü seçtiğinizden emin olun.

3. Python Eklentisinin Yüklü Olduğunu Kontrol Edin

Visual Studio Code’un Python desteği için Microsoft’un Python eklentisinin kurulu olması gerekir.

Sol taraftaki Eklentiler bölümünü açın ve arama alanına:

Python

yazın.

Microsoft tarafından yayınlanan Python eklentisinin yüklü olduğundan emin olun.

Eklenti kurulu değilse yükleyin ve ardından Visual Studio Code’u yeniden başlatın.

4. VS Code’u Yeniden Başlatın

Bazen Python veya VS Code eklentisi kurulduktan sonra program açık kaldığı için yeni ayarlar algılanmayabilir.

Bu durumda Visual Studio Code’u tamamen kapatın ve yeniden açın.

Gerekirse bilgisayarı da yeniden başlatabilirsiniz.

Bu basit işlem özellikle yeni kurulumlardan sonra sorunu çözebilir.

5. Python PATH Ayarını Kontrol Edin

Python kurulurken Add Python to PATH seçeneği işaretlenmediyse Windows terminali ve bazı programlar Python’u bulamayabilir.

Terminalde şu komut çalışmıyorsa:

python --version

ama:

py --version

çalışıyorsa Python kurulu olabilir fakat PATH ayarı eksik olabilir.

Bu durumda Python’u yeniden kurarken Add Python to PATH seçeneğini işaretlemek en pratik çözümlerden biridir.

Alternatif olarak Python’un kurulu olduğu klasörü Windows ortam değişkenlerine manuel olarak ekleyebilirsiniz.

6. Proje Klasörünü ve Sanal Ortamı Kontrol Edin

Bazı projelerde sorun genel Python kurulumundan değil, kullanılan proje ortamından kaynaklanır.

Örneğin proje içinde sanal ortam oluşturulmuşsa VS Code farklı bir Python yorumlayıcısını seçmiş olabilir.

Komut paletinden tekrar:

Python: Select Interpreter

bölümünü açın.

Listede proje klasörünüzün içindeki bir ortam görünüyorsa onu seçmeyi deneyin.

Örnek:

.venv
venv

gibi klasörler sanal ortam olabilir.

Hâlâ Python Görünmüyorsa

Yukarıdaki adımlardan sonra sorun devam ediyorsa şu kontrolleri yapın:

• Python’u kaldırıp yeniden kurun.
• VS Code Python eklentisini kaldırıp tekrar yükleyin.
• VS Code’u güncelleyin.
• Python’un kurulu olduğu dizinin gerçekten mevcut olduğunu kontrol edin.
• Birden fazla Python sürümü varsa eski sürümleri karıştırmadığınızdan emin olun.

En Sık Karşılaşılan Durum

Birçok durumda sorun şu üç nedenden birinden çıkar:

Python kurulu değil
Doğru yorumlayıcı seçilmemiş
PATH ayarı eksik

Bu üç noktayı kontrol etmek çoğu durumda yeterlidir.

Kısaca

VS Code Python’u görmüyorsa önce Python’un Windows’ta kurulu olduğunu kontrol edin. Daha sonra Visual Studio Code içinden doğru Python yorumlayıcısını seçin ve Microsoft’un Python eklentisinin yüklü olduğundan emin olun.

Sorun devam ediyorsa PATH ayarı, proje klasörü ve sanal ortam seçimi kontrol edilmelidir.