Python sanal ortamı nasıl oluşturulur ve etkinleştirilir?

İki projede aynı kütüphanenin farklı sürümleri gerekebilir. Her paketi sistem geneline kurmak, bir projeyi düzeltirken diğerini bozabilir. venv ile oluşturulan sanal ortam, projenin Python paketlerini ayrı bir alanda tutmana yardımcı olur.

Önce neyi çözmek istediğini belirle

Bir sanal ortam oluşturup terminal ve editörün aynı Python’u kullandığını doğrulayacağız. Sanal ortam bir güvenlik kasası değil, bağımlılıkları ayırma aracıdır.

Adım adım uygula

1 Ortamı oluştur. Proje klasöründe python -m venv .venv çalıştır. Bazı sistemlerde python yerine python3 kullanılır; önce sürüm komutunu kontrol et.
2 Doğru yorumlayıcıyı seç. macOS/Linux için source .venv/bin/activate; Windows PowerShell için .venv\Scripts\Activate.ps1 kullanılır. Etkinleştirme zorunlu değil; ortamın Python yolunu doğrudan da çağırabilirsin.
3 Kurulumu doğrula. python -m pip kullanarak paketi seçili yorumlayıcıya kur. Editörde de .venv içindeki yorumlayıcıyı seç ve küçük bir import dene.

Küçük bir örnek

Terminal

python -m venv .venv
# macOS / Linux:
source .venv/bin/activate
python -m pip --version
python -c "import sys; print(sys.executable)"

Sık takılınan nokta

Bir projedeki .venv klasörünü başka bilgisayara kopyalamak yerine ortamı yeniden oluştur. Git’e .venv ekleme. Aktivasyon engellenirse sistemin güvenlik ayarlarını rastgele değiştirme; ortamın Python’unu doğrudan çalıştır.

Şimdi kendin dene

Bir boş proje klasöründe ortam oluştur. sys.executable çıktısını not et; ortam dışında aynı komutu çalıştırıp yolu karşılaştır. İhtiyacın varsa paket sürümlerini proje dosyalarında kaydet.

Bir sonraki adım Python’da değişken, döngü ve liste dersleri →

Sık Karşılaşılan Hatalar, Nedenleri ve Hızlı Çözüm Tablosu

Python sanal ortamı nasıl oluşturulur ve etkinleştirilir? konusunu kendi projende uygularken en sık karşılaşılan durumları ve çözüm adımlarını aşağıdaki tabloda bulabilirsin:

Belirti / Sorun	Temel Nedeni	Nasıl Teşhis Edilir?	Kesin Çözüm
Değişiklik ekrana yansımıyor	Dosya kaydedilmemiş veya tarayıcı eski önbelleği gösteriyor	Editörde dosya adının yanında nokta işareti var mı bak	`Ctrl+S` / `Cmd+S` ile kaydet ve `Ctrl+F5` ile yenile
Büyük/küçük harf veya yol hatası	Dosya adı, seçici (`id`/`class`) veya değişken adı birebir eşleşmiyor	Konsol (F12) veya terminaldeki satır numarasını kontrol et	Türkçe karakter ve boşluk içermeyen küçük harfli adlandırma kullan
Tür veya Boş Değer (`null`/`None`) Hatası	Henüz oluşmamış bir HTML elemanına veya metin (`string`) tipindeki sayıya işlem yapmak	`console.log(typeof x)` veya `print(type(x))` ile türü yazdır	İşlem öncesi değerin varlığını (`if`) ve tür dönüşümünü (`Number`/`int`) doğrula
Ortam / Paket Uyuşmazlığı	Terminalde farklı bir klasörde veya sanal ortam dışındayken komut çalıştırmak	`pwd` (veya `cd`) ve `which python` ile konumu gör	Proje kök klasöründe doğru sanal ortamı etkinleştirerek çalıştır

Adım Adım Hata Ayıklama (Debugging) ve Temiz Kod Kontrol Listesi

1. Sorunu En Küçük Örnekte İzole Et: 200 satırlık kodda hata aramak yerine, yalnızca takıldığın satırı 5-10 satırlık küçük bir deneme alanında (Tarayıcıda Kod Dene sayfasında) tek başına çalıştır.
2. Varsayma, Konsola Yazdır: "Bu değişkenin içinde kesin 10 vardır" diye düşünmek yerine, işlemden hemen önce değişkenin değerini ve tipini ekrana yazdırarak gözünle doğrula.
3. Tek Seferde Tek Değişiklik Yap: Aynı anda hem HTML yapısını, hem CSS sınıfını hem de JavaScript fonksiyonunu değiştirirsen sorunun hangisinden kaynaklandığını bulamazsın.
4. Sınır Değerleri Test Et: Kodun normal bir girdide çalıştığında hemen bırakma; boş girdi (`""`), sıfır (`0`) veya beklenmeyen bir değer girildiğinde nasıl davrandığını da kontrol et.

Sıkça Sorulan Sorular (SSS)

Hata mesajları İngilizce olduğu için anlamakta zorlanıyorum, ne yapmalıyım? +

Hata mesajının tamamını ezberlemene gerek yoktur; yalnızca üç bilgiye odaklan: 1) Dosya adı ve satır numarası, 2) Hatanın türü (ör. SyntaxError, TypeError), 3) En sondaki kısa açıklama. Webino App'in 52 Yazılım Hatası ve Çözümü sözlüğünden Türkçe karşılıklarına anında bakabilirsin.

Bilgisayarıma program kurmadan bu örnekleri hemen deneyebilir miyim? +

Evet. Sol menüdeki Tarayıcıda Kod Dene laboratuvarını kullanarak HTML/CSS, JavaScript, Python ve SQL kodlarını hiçbir kurulum yapmadan doğrudan tarayıcında çalıştırabilirsin.

Kaynak ve devamı

Resmi belgeleri aç ↗