[Python] ModuleNotFoundError

ModuleNotFoundError Solution

코딩을 하다 보면 ModuleNotFoundError를 종종 마주하게 됩니다. 이 에러는 Python이 특정 모듈을 찾지 못했을 때 발생합니다. 아래는 이 에러를 해결하는 몇 가지 간단한 방법입니다.

---

1. 패키지 설치 여부 확인

가장 일반적인 원인은 해당 모듈이 설치되어 있지 않기 때문입니다. 모듈을 설치하려면 터미널에 아래 명령어를 입력하세요.

pip install 모듈이름

 

예를 들어 'django' 모듈이 없어서 에러가 발생했다면 아래와 같이 명령어를 입력합니다.

pip install django

---

2. 가상 환경 활성화 확인

프로젝트에서 가상 환경을 사용 중이라면 가상 환경이 활성화되어 있는지 확인하세요. 가상 환경이 활성화되지 않은 상태에서 모듈을 설치하면 그 모듈은 전역 Python 환경에 설치될 수 있습니다. 이 경우 가상 환경에서 해당 모듈을 찾지 못하게 되어 에러가 발생합니다.

# Windows
(내 가상 환경 이름)/Scripts/activate

# macOS/Linux
source (내 가상 환경 이름)/bin/activate

---

3. 패키지 설치된 경로 확인

모듈이 올바른 위치에 설치되었는지 확인하려면 아래 명령어를 터미널에 입력하여 설치 경로를 확인할 수 있습니다.

pip show 모듈이름

---

4. 파이썬 버전 확인

모듈을 설치할 때 사용한 파이썬 버전과 실행할 때 사용하는 파이썬 버전이 일치하는지 확인해 보세요.

python --version

---

5. 인터프리터 확인

vscode 기준 (ctrl + shift + p)를 누르고 interpreter를 검색하면 interpreter 선택 창이 나옵니다. 이 창을 클릭하면 아래와 같은 화면이 나오는데, 현재 적용되어 있는 인터프리터 설정을 확인할 수 있습니다.

 

---

6. 오타 확인

생각보다 오타로 인해 ModuleNotFoundError가 발생하는 경우가 많습니다. 철자가 정확한지 확인해 주세요.

---

7. 재부팅

위의 절차를 전부 확인해도 에러가 해결되지 않는 경우가 간혹 있습니다. 그런 경우 에디터 재부팅을 해보시길 권합니다.