ModuleNotFoundError: No module named ... 오류는 파이썬 입문자가 아주 자주 만나는 문제입니다. 대부분은 패키지가 아예 없는 경우보다, 설치한 환경과 실행 중인 환경이 다를 때 생깁니다.
즉 pip install은 성공했는데 import에서 오류가 난다면, 거의 항상 현재 보고 있는 파이썬 환경부터 다시 확인하는 편이 맞습니다.
Table of Contents
가장 먼저 확인할 것
python --version
python -m pip --version이 두 명령어를 같이 보면 현재 어떤 파이썬을 실행 중인지, pip가 어느 환경에 연결돼 있는지 빠르게 확인할 수 있습니다.
자주 생기는 원인
다른 파이썬에 패키지를 설치한 경우
가장 흔한 경우입니다. 설치한 환경과 실행한 환경이 다르면 import 오류가 납니다.
VS Code 인터프리터가 다른 경우
터미널에서는 되는데 VS Code 실행에서는 안 된다면, 선택된 인터프리터가 다를 가능성이 큽니다.
가상환경을 켜지 않은 경우
프로젝트별 가상환경을 쓰는 중이라면 실행 전에 활성화되어 있는지 먼저 확인해야 합니다.
확인 순서
python -m pip --version으로 pip 연결 환경 확인python -c "import 패키지명"으로 직접 테스트- VS Code 인터프리터 확인
- 가상환경 사용 중이면 활성화 여부 확인
가장 안전한 설치 방식
python -m pip install 패키지명가능하면 pip install 패키지명보다 위처럼 python -m pip 형식을 쓰는 편이 안전합니다. 현재 실행 중인 파이썬 기준으로 설치되기 때문입니다.
이럴 때 특히 많이 생깁니다
- 시스템 파이썬과 가상환경을 같이 쓰는 경우
- Windows에서
python,py,python3가 섞인 경우 - VS Code에서 다른 인터프리터가 선택된 경우
정리
- 이 오류는 패키지가 없어서보다 다른 환경을 보고 있을 때 더 자주 생깁니다
python --version과python -m pip --version을 같이 보면 문제를 빨리 좁힐 수 있습니다- VS Code와 가상환경 설정까지 같이 보면 대부분 해결됩니다
함께 보면 좋은 글: