ModuleNotFoundError: No module named 'cv2' 해결방법

어제 vscode로 프로젝트를 진행하다 첫 시작, 필요한 라이브러리를 임포트하는 부분에서부터 계속 에러가 떴다. pip install을 시켜줬는데도 계속 모듈을 찾지 못하길래 엄청난 구글링을 통해 에러를 해결했다. 나와 같은 문제를 겪을 사람을 위해 해결법을 블로그에 작성해놔야겠다 생각이 들었다. 

---

Trouble Shooting

ModuleNotFoundError: No module named 'cv2' 

 

1. cv2 모듈이 포함된 opencv 라이브러리 설치

pip install opencv-python

 

2. 설치한 경우에도 같은 오류가 뜨는 경우 -> 다양한 방법 시도

1) Python 환경 확인

• OpenCV를 설치한 Python 환경과 코드를 실행하는 Python 환경이 동일한지 확인해보자. 가끔 여러 Python 환경이 있는 경우가 있고, 패키지는 하나의 환경에만 설치될 수 있다. 설치된 패키지를 확인하려면 pip list 명령어를 실행하면 된다.

2) pip upgrade

• pip가 가장 최신 버전이 아니어서 이러한 에러가 날 수도 있다. pip를 업그레이드 해보자. 

pip install --upgrade pip

3) numpy 버전 upgrade(필수)

• 설치된 numpy의 버전이 설치된 OpenCV의 버전과 호환되지 않아 발생하는 문제일 수 있다. numpy를 업그레이드 시켜보자. 

#시도
pip install numpy --upgrade

#위 코드가 작동하지 않는다면 아래 코드 시도
pip install numpy --upgrade --ignore-installed

4) OpenCV 다시 설치

• OpenCV를 삭제했다가 다시 설치해보자. 

pip uninstall opencv-python
pip install opencv-python