Python

ModuleNotFoundError가 뜰 때 확인할 것

설치 위치와 실행 인터프리터가 다르면 모듈을 찾지 못합니다. 설치한 파이썬과 실행 중인 파이썬을 맞추는 것이 핵심입니다.

python에러모듈

ModuleNotFoundError는 설치 위치와 실행 인터프리터가 다를 때 가장 많이 발생합니다. 예를 들어 시스템 파이썬에 설치했는데, 가상환경 파이썬으로 실행하면 모듈을 찾지 못합니다.

따라서 설치 명령과 실행 명령이 같은 환경인지 확인해야 합니다. python -m pip 방식이 안전합니다.

IDE에서 인터프리터를 잘못 선택한 경우도 흔합니다. 설정에서 현재 프로젝트 인터프리터를 확인하세요.

아래 방법으로 환경을 정리해보세요.

  • python -m pip install ... 사용
  • which python / where python으로 경로 확인
  • IDE 인터프리터 설정 확인
  • 가상환경 재활성화

파이썬 패키지는 운영체제나 아키텍처에 따라 설치 방식이 달라질 수 있으니, 공식 문서의 설치 가이드를 함께 확인하세요.

추가로 확인할 점은 같은 문제가 언제, 어떤 환경에서 반복되는지 기록해두는 것입니다. 시간대와 사용 패턴을 메모하면 원인 파악이 훨씬 빨라집니다.

광고 영역

자주 묻는 질문

Q. pip로 설치했는데도 계속 안 돼요.
설치한 pip가 다른 파이썬을 가리키는 경우가 많습니다.
Q. Jupyter에서만 오류가 나요.
커널이 다른 환경일 수 있으니 커널 선택을 확인하세요.
Q. requirements.txt 설치 후에도 안 돼요.
가상환경이 활성화된 상태인지 다시 확인하세요.
광고 영역