Python의존성
Python ModuleNotFoundError — No module named
ModuleNotFoundError: No module named '<module>'
한 줄 해결: 파이썬이 import할 모듈을 찾지 못한 것으로, 미설치·가상환경 불일치·import 경로 문제가 원인입니다. 활성화된 환경에 pip로 설치하면 대부분 해결됩니다.
이런 증상일 때
python 실행 시 ModuleNotFoundError가 뜨며 못 찾은 모듈명이 출력됩니다. 설치한 것 같은데 안 잡히는 경우는 보통 다른 가상환경/파이썬에 설치된 것입니다.
원인
- 패키지를 아예 설치하지 않음
- 가상환경(venv/conda)을 활성화하지 않았거나, 설치한 환경과 실행 환경이 다름
- 로컬 모듈의 경우 PYTHONPATH·패키지 구조(__init__.py) 문제
해결 방법
1
활성 환경 확인 후 설치
지금 쓰는 파이썬/환경에 설치합니다. python -m pip를 쓰면 실행 중인 인터프리터에 정확히 설치됩니다.
python -m pip install <module>2
가상환경 활성화
프로젝트 venv를 활성화한 뒤 설치/실행합니다.
source .venv/bin/activate # Windows: .venv\Scripts\activate3
어느 파이썬인지 확인
which python과 pip가 같은 환경을 가리키는지 점검합니다.
which python && python -c "import sys; print(sys.executable)"💡 예방: 프로젝트마다 venv를 만들고 requirements.txt로 의존성을 고정하세요. python -m pip 습관이 환경 불일치를 예방합니다.
PythonModuleNotFoundErrorpipvenv가상환경