[OpenCV] ModuleNotFoundError: No module named 'cv2'

에러 메시지 설명

  ModuleNotFoundError: No module named 'cv2'는 OpenCV 라이브러리가 파이썬 환경에 설치되지 않았거나, 파이썬이 cv2 모듈을 찾지 못할 때 발생하는 오류입니다. OpenCV는 이미지 및 비디오 처리에 널리 사용되는 라이브러리이며, 이 오류는 해당 모듈이 시스템에 설치되지 않았거나 환경 설정에 문제가 있을 때 발생합니다.

 

발생 원인

• OpenCV 미설치: 가장 흔한 원인은 시스템에 OpenCV가 설치되지 않았거나 올바르게 설치되지 않은 경우입니다.
• 가상 환경 문제: 파이썬 가상 환경을 사용 중이라면, 해당 환경에 OpenCV가 설치되지 않았을 수 있습니다.

 

해결 방법

OpenCV 설치하기

  해당 오류는 OpenCV가 설치되어 있지 않다는 의미일 수 있습니다. OpenCV를 설치하려면 다음 명령어를 입력합니다.

pip install opencv-python

 

관련 내용 및 추가 팁

• 추가 패키지 설치: OpenCV의 특정 기능을 사용하기 위해 추가 패키지(예: opencv-contrib-python)가 필요할 수 있습니다. 이를 설치하려면 다음 명령어를 입력합니다.

pip install opencv-contrib-python

• OpenCV 공식 문서
• PyPI opencv-python 페이지