[Python] ModuleNotFoundError 해결 방법

Python을 처음 배우는 사람이라면 라이브러리를 설치한 후에도 'ModuleNotFoundError'라는 오류를 종종 만나게 됩니다. 이 오류는 Python 환경에서 특정 라이브러리를 찾을 수 없을 때 발생합니다. 이번 포스팅에서는 ModuleNotFoundError의 원인과 이를 해결하는 방법을 단계별로 자세히 설명하겠습니다.

---

1. 오류 또는 코드 설명

오류 메시지 예시

Python에서 'numpy' 라이브러리를 사용하려고 할 때 발생할 수 있는 오류 메시지 예시는 다음과 같습니다:

import numpy

실행 결과:

ModuleNotFoundError: No module named 'numpy'

이 오류는 Python 인터프리터가 'numpy'라는 이름의 모듈을 찾지 못할 때 발생합니다. Python 초보자들이 많이 마주하는 문제로, 올바른 설치 방법과 경로 설정이 필요합니다.

---

2. 원인 분석

ModuleNotFoundError의 발생 원인

1. 라이브러리가 설치되지 않음 - pip로 설치하지 않았거나, 설치 과정에서 오류가 발생한 경우.
2. 다른 Python 환경 사용 중 - 가상 환경(venv)이나 conda 환경을 사용하면서 설치가 다른 환경에 적용된 경우.
3. 경로 설정 문제 - 설치된 경로와 Python이 참조하는 경로가 다른 경우.

---

3. 해결 방법

1) pip로 라이브러리 설치하기

일반적으로 ModuleNotFoundError는 라이브러리가 설치되지 않아 발생합니다. 다음 명령어로 설치할 수 있습니다:

pip install numpy

설치 확인:

pip show numpy

2) 올바른 Python 환경 확인하기

가상환경을 사용 중이라면, 터미널에서 다음 명령어로 확인합니다:

which python  # Windows의 경우: where python

3) 가상환경 설정 후 설치하기 (선택 사항)

python -m venv myenv
source myenv/bin/activate  # Windows의 경우: myenv\Scripts\activate
pip install numpy

4) 설치 경로 문제 해결하기

설치된 라이브러리의 경로를 확인하여 Python이 참조할 수 있는지 확인합니다.

python -m site

---

4. 추가 팁 및 참고 사항

• 항상 'pip list' 명령어로 설치된 패키지를 확인하세요.
• 파이썬 버전에 따라 'pip3' 명령어를 사용할 수도 있습니다.
• 가상환경을 사용할 때는 활성화된 상태에서 설치하세요.

---

5. 요약 및 마무리

이번 포스팅에서는 Python에서 ModuleNotFoundError 오류의 원인과 해결 방법을 알아보았습니다. 일반적으로 pip 명령어로 라이브러리를 설치하면 문제가 해결되지만, 가상환경 설정이나 경로 문제도 확인하는 것이 중요합니다. 올바른 설치 경로를 확인하여 오류를 해결해보세요.

---

6. 관련 글

• 관련 글: Python에서 ImportError와 ModuleNotFoundError의 차이