728x90
ModuleNotFoundError: No module named 'nonexistent' 오류는 파이썬에서 존재하지 않는 모듈을 임포트(import)하려고 할 때 발생합니다. 이 오류는 해당 모듈이 설치되지 않았거나, 모듈 이름을 잘못 입력했거나, 모듈의 위치가 현재 환경에 인식되지 않을 경우 발생합니다.
오탈자, 가상 환경 내 패키지 미설치, 또는 파이썬 버전에 따라 지원되지 않는 외부 모듈 사용 등이 주요 원인입니다. 또한 패키지 구조가 변경되어 경로가 바뀌었을 경우에도 이 오류가 발생할 수 있습니다.
● 오류 발생 예시
import nonexistent위 코드는 nonexistent라는 모듈이 존재하지 않기 때문에 오류가 발생합니다.
ModuleNotFoundError: No module named 'nonexistent'● 해결 방법
- 오탈자 확인: 모듈 이름 철자 정확히 입력
pip install명령어로 해당 모듈 설치- 작업 중인 가상환경(venv)에서 설치 여부 재확인
- sys.path 또는 PYTHONPATH 설정 확인
● 예시 코드
# 잘못된 예시
import numppy # 오탈자
# 올바른 예시
import numpy● 자주 하는 실수
- 패키지 이름을 잘못 입력 (예:
pandas_datareadr→pandas_datareader) - 설치하지 않고 사용하려고 시도
- 다른 환경에 설치되어 있다고 착각하고 진행
● 결론
ModuleNotFoundError - No module named 'X' 오류는 해당 모듈이 존재하지 않거나, 현재 환경에서 사용할 수 없을 때 발생합니다. 정확한 이름 확인과 설치 여부 검토, 가상환경 활성화 등 기본적인 확인 절차를 통해 해결할 수 있습니다.
728x90
