ModuleNotFoundError란 무엇인가?
ModuleNotFoundError는 가져오려는(import) 모듈을 Python이 찾을 수 없을 때 발생하는 예외다. 이 오류는 Python 3.6부터 도입되었으며, 이전 버전에서는 ImportError가 발생했다. 이는 초보자부터 숙련된 개발자까지, 특히 새로운 프로젝트나 환경을 설정할 때 가장 흔하게 겪는 문제 중 하나다.
오류 메시지는 보통 매우 명확하다.
ModuleNotFoundError: No module named 'some_module'
이는 Python이 설치된 모듈 목록에서 some_module을 찾아봤지만 찾지 못했다는 의미다.
ModuleNotFoundError의 일반적인 원인
- 모듈이 설치되지 않음: 가장 흔한 원인으로, 사용 중인 Python 환경에 해당 모듈이 설치되어 있지 않은 경우다.
- 모듈 이름의 오타:
import문에서 모듈 이름을 잘못 입력했을 수 있다. - 잘못된 Python 환경: 여러 Python 설치 버전이나 가상 환경이 있을 때, 모듈은 한 환경에 설치되어 있는데 스크립트는 다른 환경에서 실행하고 있을 수 있다.
- 순환 종속성: 드물게, 두 개 이상의 모듈이 서로를 순환적으로 가져오는 경우 가져오기 문제가 발생할 수 있다.
ModuleNotFoundError 해결 방법
이 오류를 해결하고 수정하는 방법은 다음과 같다.
1. pip로 누락된 모듈 설치
모듈이 설치되어 있지 않다면, 보통 Python의 패키지 설치 프로그램인 pip를 사용해 설치할 수 있다. 터미널이나 명령 프롬프트를 열고 다음을 실행하자.
pip install some_module
some_module을 필요한 실제 모듈 이름으로 바꾸면 된다. 예를 들어, 인기 있는 requests 라이브러리를 설치하려면 다음을 실행한다.
pip install requests
참고: 때로는 pip로 설치하는 패키지 이름이 가져오는 모듈 이름과 다를 수 있다. 예를 들어, cv2 모듈을 사용하려면 opencv-python을 설치해야 한다. 보통 인터넷에서 간단히 검색하면 올바른 패키지 이름을 찾을 수 있다.
2. 오타 확인
import 문에 철자 오류가 있는지 주의 깊게 확인하자. 쉽게 저지를 수 있는 실수다.
# 잘못된 예: 'requests'에 오타
import reqeusts
# 올바른 예
import requests
3. Python 환경 확인
여러 버전의 Python(예: Python 2.7과 Python 3.8)이 설치되어 있거나 가상 환경을 사용하는 경우, 스크립트를 실행하는 환경과 동일한 환경에 패키지를 설치하고 있는지 확인해야 한다.
다음 명령으로 사용 중인 Python 버전을 확인할 수 있다.
python --version
# 또는
python3 --version
사용 중인 Python 환경에 맞는 pip를 사용하려면, pip를 모듈로 실행할 수 있다.
python -m pip install some_module
이 명령은 현재 실행 중인 python 실행 파일에 대해 패키지가 설치되도록 보장한다.
4. 가상 환경 이해하기
가상 환경은 Python 개발의 모범 사례다. 각 프로젝트마다 고유한 설치된 패키지 집합을 가진 격리된 환경을 만들 수 있게 해준다.
가상 환경(venv나 conda로 생성)을 사용하는 경우, 패키지를 설치하거나 스크립트를 실행하기 전에 해당 환경을 활성화했는지 확인해야 한다.
venv 환경을 활성화하려면:
- Windows:
my-env\Scripts\activate - macOS/Linux:
source my-env/bin/activate
활성화되면 터미널 프롬프트가 보통 환경 이름을 표시하도록 변경된다. 그 후 pip install 명령은 활성화된 환경에만 적용된다.
결론
ModuleNotFoundError는 보통 쉽게 해결할 수 있는 흔한 장애물이다. 올바른 pip로 모듈을 설치하고, 오타를 확인하며, 올바른 Python 환경에서 작업하고 있는지 확인함으로써 이 오류를 신속하게 해결하고 코딩으로 돌아갈 수 있다. 프로젝트 시작부터 가상 환경을 사용하는 것은 이러한 문제를 전반적으로 예방하는 좋은 방법이다.
Leave a comment