Ulaşım
- Adres:Batıkent Mh. 8910 Sk. 6. Etap 1H No: 18 Yeni Toki Eyyübiye / Şanlıurfa (Yeni Alım Satım Karşısı)
- Telefon:0 (545) 528 88 93
- eMail: info@alestaweb.com
Python'da "ModuleNotFoundError: No module named 'cv2'" hatası mı alıyorsunuz? OpenCV kurulumu yaptınız ama cv2 modülü bulunamıyor mu (cv2 module not found)? Alesta Web olarak bu hatayı (this error) 5 dakikada çözmenize yardımcı olacağız. Görüntü işleme (computer vision) projelerinize hemen başlayabileceksiniz!
Python'da görüntü işleme (image processing) veya bilgisayarlı görü (computer vision) projeleri geliştirirken en sık karşılaşılan hatalardan biri ModuleNotFoundError: No module named 'cv2' hatasıdır. Bu hata mesajı (error message), Python'un OpenCV kütüphanesini bulamadığını gösterir.
Traceback (most recent call last):
File "script.py", line 1, in <module>
import cv2
ModuleNotFoundError: No module named 'cv2'
Bu hata, kodunuzda import cv2 satırını çalıştırmaya çalıştığınızda ortaya çıkar.
Alesta Web olarak yüzlerce Python geliştiricisinin bu hatayı (this cv2 import error) çözmesine yardımcı olduk. Şimdi size adım adım (step by step) çözüm yollarını gösterelim.
ModuleNotFoundError cv2 hatası genellikle şu sebeplerden kaynaklanır:
Deneyimlerimize göre bu hatanın %80'i (80% of this error) yanlış Python ortamında çalışmaktan kaynaklanıyor. Önce hangi Python sürümünde çalıştığınızı kontrol edin!
En temel çözüm, OpenCV paketini pip ile kurmaktır. Alesta Web ekibi olarak önerdiğimiz komut:
Windows: Win + R tuşlarına basın, cmd yazıp Enter'a basın
Linux/Mac: Terminal uygulamasını açın
pip install opencv-python
Eğer pip3 kullanıyorsanız:
pip3 install opencv-python
pip show opencv-python
Bu komut size kurulu sürüm bilgisini gösterecektir (will show installed version). 2025 itibariyle en güncel sürüm opencv-python 4.12.x.
Eğer pip show komutu paket bilgilerini gösteriyorsa, kurulum başarılı (installation successful)! Artık import cv2 çalışmalı.
Birden fazla Python sürümünüz varsa (multiple Python versions), OpenCV'yi yanlış sürüme kurmuş olabilirsiniz. Alesta Web olarak önerdiğimiz kesin çözüm:
python --version python3 --version
Çıktı örneği: Python 3.12.0
python -m pip install opencv-python
Veya Python 3 için:
python3 -m pip install opencv-python
Bu yöntem, kodunuzu çalıştırdığınız Python sürümüne direkt olarak paket kurar (installs directly to the Python version you're using).
VS Code, PyCharm gibi IDE'lerde çalışıyorsanız, IDE'nin kullandığı interpreter'ı kontrol edin. Ayarlar → Python Interpreter bölümünden doğru sürümü seçtiğinizden emin olun!
Python projelerinde virtual environment (venv) kullanıyorsanız, OpenCV'yi o ortama kurmalısınız. İşte adım adım (step by step) nasıl yapılır:
Windows:
# Virtual environment oluşturma (create) python -m venv myenv # Aktivasyon (activate) myenv\Scripts\activate
Linux/Mac:
# Virtual environment oluşturma python3 -m venv myenv # Aktivasyon source myenv/bin/activate
# Virtual environment aktif olduğunda (when active) pip install opencv-python
Terminal başında (myenv) gibi bir işaret görüyorsanız, sanal ortam aktiftir.
Alesta Web deneyimlerine göre, virtual environment kullanımı paket çakışmalarını (package conflicts) önler ve projelerinizi daha güvenli hale getirir.
Eski pip sürümleri OpenCV kurulumunda hataya neden olabilir (old pip versions cause errors). pip 19.3 ve üzeri gereklidir:
pip --version
Çıktı: pip 24.3.1 gibi bir değer görmelisiniz (2025 güncel sürüm).
python -m pip install --upgrade pip
Veya:
pip install --upgrade pip
python -m pip install opencv-python
Alesta Web uzmanları olarak her zaman en güncel pip kullanmanızı öneriyoruz (we always recommend using the latest pip).
Farklı OpenCV paketleri aynı anda kuruluysa çakışma olur (package conflicts occur). Şu paketler birlikte KULLANILAMAZ:
pip uninstall opencv-python opencv-contrib-python opencv-python-headless opencv-contrib-python-headless -y
Temel kullanım için:
pip install opencv-python
Ekstra özellikler (SIFT, SURF vb.) için:
pip install opencv-contrib-python
Sunucu/Headless ortam için:
pip install opencv-python-headless
Masaüstü projeler için opencv-python, makine öğrenmesi projeleri için opencv-contrib-python kullanın. İkisini birden kurmayın!
OpenCV kurulumundan sonra çalışıp çalışmadığını test edelim:
python >>> import cv2 >>> print(cv2.__version__) 4.12.0 >>> exit()
Hata almadan (no error) sürüm numarasını görüyorsanız, başarılı!
import cv2
import numpy as np
# Siyah bir görüntü oluştur (create black image)
img = np.zeros((512, 512, 3), np.uint8)
# Görüntüyü göster (show image)
cv2.imshow('Test Image', img)
cv2.waitKey(0)
cv2.destroyAllWindows()
print("OpenCV başarıyla çalışıyor! (OpenCV working successfully!)")
Bu kodu çalıştırın. Pencere açılıyorsa, OpenCV düzgün kurulmuş demektir.
Alesta Web ekibi olarak her kurulumdan sonra test yapmanızı şiddetle öneriyoruz (we strongly recommend testing after installation).
Sebep: Python sürümünüz çok eski veya çok yeni (Python version too old or too new)
Çözüm:
# Python sürümünü kontrol edin python --version # Python 3.8 - 3.12 arası kullanın (use Python 3.8-3.12) # Eğer 3.6 veya daha eskiyse Python güncelleyin
Sebep: Visual C++ Redistributable eksik
Çözüm:
Çözüm:
# Sudo ile kurulum (install with sudo) sudo pip3 install opencv-python # VEYA kullanıcı modunda kurulum (user mode installation) pip3 install --user opencv-python
Raspberry Pi'de ek kütüphaneler gerekebilir (additional libraries may be needed):
sudo apt-get install libcblas-dev libhdf5-dev libhdf5-serial-dev libatlas-base-dev libjasper-dev libqtgui4 libqt4-test
Bu makalede kullanılan bilgiler aşağıdaki güvenilir kaynaklardan alınmıştır (information used in this article is from the following reliable sources):
Alesta Web olarak tüm bilgileri doğruladık ve test ettik (we verified and tested all information). Güncel Python 3.12 ve OpenCV 4.12 sürümleriyle uyumludur.
Artık ModuleNotFoundError: No module named 'cv2' hatası geride kaldı. Alesta Web olarak görüntü işleme (computer vision) projelerinizde sorun yaşarsanız bizimle alestaweb.com üzerinden iletişime geçebilirsiniz.
Hızlı Özet / Quick Summary:
Faydalı Linkler / Useful Links:
OpenCV kurulumunu tamamladınız! Şimdi görüntü işleme (image processing), yüz tanıma (face recognition), nesne tespiti (object detection) gibi projeler geliştirebilirsiniz. Alesta Web ekibi size yol göstermeye hazır!
© 2025 AlestaWeb - Tüm hakları saklıdır. Bu rehber Python 3.8-3.12 ve OpenCV 4.x sürümleri için güncellenmiştir.