NumPy kurulumu yapılırken Python ortamı nasıl doğrulanır?

NumPy kurmadan önce hangi Python yorumlayıcısını ve hangi paket yöneticisini kullanacağınızı doğrulayın. Bunun için sürümü, çalıştırılabilir dosyanın konumunu ve pip bağlantısını kontrol edin; ardından mümkünse proje için ayrı bir sanal ortam oluşturup NumPy’yi aynı ortam içindeki Python ile yükleyin. Son kontrolde NumPy’nin sürümü ve kurulduğu dosya yolu görünüyorsa ortam doğru seçilmiştir.

Kurulumdan önce Python ortamını doğrulama​

Komutları işletim sisteminizin terminalinde, Windows’ta PowerShell veya Komut İstemi’nde, macOS ve Linux’ta Terminal’de çalıştırın. Birden fazla Python kurulumu varsa yalnızca python komutuna güvenmek yerine aşağıdaki komutlardan sisteminize uygun olanı kullanın.
Bu ayrım önemlidir: pip komutunu tek başına çalıştırmak, farklı bir Python kurulumuna bağlı pip’i çağırabilir. python -m pip biçimi ise pip’i seçtiğiniz Python yorumlayıcısıyla çalıştırır.

Windows​

1. Python sürümünü görüntüleyin. PowerShell veya Komut İstemi’nde py -3 --version çalıştırın. Çıktıda Python 3 sürümü görünmelidir. py tanınmıyorsa Python kurulumu veya PATH ayarı bu komutla doğrulanamaz; kullandığınız Python kurulumunun tam yolunu ya da kurulum sırasında eklenen python komutunu kontrol edin.
2. Yorumlayıcının konumunu yazdırın. py -3 -c "import sys; print(sys.executable)" komutunu çalıştırın. Çıktı, gerçekten kullanılacak Python çalıştırılabilir dosyasının tam yoludur.
3. Pip’in aynı Python’a bağlı olduğunu kontrol edin. py -3 -m pip --version komutunu çalıştırın. Çıktıda pip sürümüyle birlikte bir Python site-packages yolu görünmelidir.
4. İsterseniz proje için sanal ortam oluşturun. Proje klasöründe py -3 -m venv .venv çalıştırın; bu işlem .venv klasörünü oluşturur.
5. Sanal ortamı etkinleştirin. PowerShell’de .venv\Scripts\Activate.ps1, Komut İstemi’nde .venv\Scripts\activate.bat çalıştırın. Komut satırının başında genellikle (.venv) ifadesi görünür.

macOS veya Linux​

1. Python sürümünü görüntüleyin. python3 --version çalıştırın ve Python 3 sürümünün yazdırıldığını doğrulayın.
2. Yorumlayıcının konumunu yazdırın. python3 -c "import sys; print(sys.executable)" komutu, seçilen Python çalıştırılabilir dosyasının tam yolunu gösterir.
3. Pip’in aynı Python’a bağlı olduğunu kontrol edin. python3 -m pip --version çalıştırın. Pip bulunamıyorsa, kullandığınız Python kurulumunda pip’in eksik olup olmadığını belirlemek için python3 -m ensurepip --default-pip komutu değerlendirilebilir; işletim sisteminizin paket yönetimi politikalarını göz ardı ederek sistem Python’una paket yüklemeyin.
4. Sanal ortam oluşturun. Proje klasöründe python3 -m venv .venv çalıştırın. Komut, proje içinde .venv adlı ayrı bir Python ortamı oluşturur.
5. Sanal ortamı etkinleştirin. macOS veya Linux kabuklarında source .venv/bin/activate çalıştırın. Ardından python -c "import sys; print(sys.executable)" komutunu yeniden çalıştırın; yolun .venv içinden geçtiğini görmelisiniz.

NumPy’yi doğrulanmış ortama kurma​

Sanal ortam etkinse aşağıdaki komutlarda python kullanın. Sanal ortam kullanmıyorsanız Windows’ta py -3, macOS veya Linux’ta python3 komutunu -m pip ile birlikte kullanın.

1. NumPy’yi kurun. Etkin ortamda python -m pip install numpy komutunu çalıştırın. Kurulum tamamlandığında terminalde başarıyla yüklenen paket bilgileri ve komut satırına dönen bir istem görmelisiniz.
2. NumPy’nin import edilebildiğini test edin. python -c "import numpy as np; print(np.__version__); print(np.__file__)" komutunu çalıştırın. İlk satır NumPy sürümünü, ikinci satır NumPy paketinin dosya konumunu yazdırır.
3. Çıktının ortamla eşleştiğini kontrol edin. Yalnız iki yolda da .venv adının bulunması yeterli değildir; farklı projelerde aynı adlı ortamlar olabilir. sys.executable çıktısını hedeflediğiniz Python dosyasının tam yoluyla karşılaştırın. Varsayılan yalıtılmış ortamda np.__file__ de o ortamın paket dizinini göstermelidir. Ortamın kökü sys.prefix ile görülebilir; bu ayrım Python’un venv belgesinde açıklanır.

Sonucun anlamı ve yaygın ayrımlar​

python --version veya eşdeğeri başarılı olsa bile bu yalnızca Python komutunun çalıştığını kanıtlar; NumPy’nin kurulduğunu kanıtlamaz. python -m pip --version başarılıysa pip’in seçilen Python üzerinden çağrılabildiği anlaşılır, ancak NumPy’nin kullanılabilir olduğu ancak import testiyle doğrulanır.

No module named pip hatası pip’in seçtiğiniz Python ortamında bulunmadığını gösterir. No module named numpy hatası ise çoğunlukla NumPy’nin başka bir Python’a kurulmuş olduğunu veya sanal ortam etkin değilken test yapıldığını gösterir. Bu durumda önce sys.executable yolunu, sonra aynı yorumlayıcıyla -m pip install numpy komutunu kontrol edin.

Import sırasında ikili dosya, mimari veya sürüm uyumsuzluğu hatası alırsanız hata metnini ve şu üç çıktıyı birlikte saklayın: Python sürümü, sys.executable yolu ve python -m pip --version sonucu. Bunlar, sorunun yanlış ortam mı yoksa paket ile Python/platform uyumsuzluğu mu olduğunu ayırmak için gereken temel bilgilerdir.