Bir paketin başarıyla kurulması, uygulamanızın aynı Python ortamını kullandığını göstermez. Bilgisayarda birden fazla yorumlayıcı veya projeye özel sanal ortam bulunabilir. Hata çözümüne paketi tekrar tekrar kurarak değil, çalışan yorumlayıcıyı belirleyerek başlayın.
Yorumlayıcının kimliğini kaydedin
Uygulamanın hangi Python çalıştırılabilir dosyasından başlatıldığını kontrol edin. Komut satırı, editörün çalıştır düğmesi ve arka plan görevi farklı yollar kullanabilir. Üçünde de aynı projenin sanal ortamını seçtiğinizden emin olun.
Venv, projenin paketlerini varsayılan olarak temel ortamdan ayırır. Windows'ta ortamın Scripts dizini, diğer yaygın sistemlerde bin dizini bu incelemede önemlidir. Etkinleştirilmiş görünen bir terminalin editör ayarını otomatik değiştirdiğini varsaymayın.
Ortamı proje kodundan ayırın
Sanal ortam klasörünün içine uygulama dosyalarınızı koymayın. Ortam yeniden oluşturulabilir olmalı; proje kodu ve bağımlılık tanımı ayrı korunmalıdır. Hazır ortam klasörünü başka bilgisayara kopyalamak yerine hedef sistemde yeniden kurma yaklaşımını kullanın.
Küçük doğrulama akışı
Önce yorumlayıcı yolunu not edin. Sonra kurulum komutunu aynı yorumlayıcıya bağlı paket aracıyla çalıştırın. Uygulamayı tekrar başlattığınızda hatanın değişip değişmediğini kaydedin. Bu sırada gerçek üretim ortamındaki paketleri topluca güncellemeyin.
Çözüm kaydını tekrarlanabilir tutun
Hata raporuna işletim sistemi, Python sürümü, kullanılan ortam yolu ve tam modül adını ekleyin. Kullanıcı parolası veya erişim anahtarını paylaşmayın. Sorun devam ediyorsa paket adı ile import adının farklı olabileceğini ayrıca inceleyin. Bu rehber ortam uyuşmazlığını ele alır; her modül hatasının nedeni aynı değildir.
