ModuleNotFoundError는 설치 위치와 실행 인터프리터가 다를 때 가장 많이 발생합니다. 예를 들어 시스템 파이썬에 설치했는데, 가상환경 파이썬으로 실행하면 모듈을 찾지 못합니다.
따라서 설치 명령과 실행 명령이 같은 환경인지 확인해야 합니다. python -m pip 방식이 안전합니다.
IDE에서 인터프리터를 잘못 선택한 경우도 흔합니다. 설정에서 현재 프로젝트 인터프리터를 확인하세요.
아래 방법으로 환경을 정리해보세요.
- python -m pip install ... 사용
- which python / where python으로 경로 확인
- IDE 인터프리터 설정 확인
- 가상환경 재활성화
파이썬 패키지는 운영체제나 아키텍처에 따라 설치 방식이 달라질 수 있으니, 공식 문서의 설치 가이드를 함께 확인하세요.
추가로 확인할 점은 같은 문제가 언제, 어떤 환경에서 반복되는지 기록해두는 것입니다. 시간대와 사용 패턴을 메모하면 원인 파악이 훨씬 빨라집니다.
광고 영역
자주 묻는 질문
- Q. pip로 설치했는데도 계속 안 돼요.
- 설치한 pip가 다른 파이썬을 가리키는 경우가 많습니다.
- Q. Jupyter에서만 오류가 나요.
- 커널이 다른 환경일 수 있으니 커널 선택을 확인하세요.
- Q. requirements.txt 설치 후에도 안 돼요.
- 가상환경이 활성화된 상태인지 다시 확인하세요.
광고 영역