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