👉 "Python 실행 시 'ModuleNotFoundError: No module named ○○' 오류 해결 방법"

파이썬을 사용하다 보면 가장 흔히 만나는 오류 중 하나가 바로

ModuleNotFoundError: No module named 'xxx'

입니다.
특히 처음 라이브러리를 설치하고 나서 실행할 때 많이 발생하죠.

---

1. 원인

이 오류는 파이썬이 해당 모듈(라이브러리)을 찾을 수 없을 때 발생합니다.
주된 원인은 다음과 같습니다:

• 라이브러리가 설치되지 않음
• 가상환경(venv, conda 등) 문제
• Python 버전이 달라서 설치가 꼬임
• 설치는 했지만 다른 환경에 설치됨

---

2. 해결 방법

✅ 1) 라이브러리 설치 확인

가장 먼저 설치가 되어 있는지 확인해야 합니다.

 

pip show requests

만약 결과가 없다면 아래와 같이 설치합니다.

pip install requests

✅ 2) pip와 python 버전 맞추기

간혹 pip로 설치했는데 실행은 python3 환경에서 돌려서 충돌하는 경우가 있습니다.

• Windows:
• bash
  복사편집
  py -m pip install requests
• Mac/Linux:
• bash
  복사편집
  python3 -m pip install requests

✅ 3) 가상환경 확인

프로젝트마다 다른 환경을 쓰는 경우, 설치한 모듈이 다른 가상환경에 들어가 있을 수 있습니다.

• venv 활성화:
• source venv/bin/activate
• conda 활성화:
• conda activate myenv

✅ 4) Jupyter Notebook에서 오류 발생 시

Jupyter에서는 커널이 다른 Python 버전을 가리키고 있을 수 있습니다.

pip install ipykernel python -m ipykernel install --user

이후 Jupyter에서 원하는 환경을 선택하면 해결됩니다.

---

3. 정리

• ModuleNotFoundError는 대부분 설치 문제 or 환경 문제에서 발생
• 설치 시 Python 버전과 pip 버전을 반드시 맞출 것
• 가상환경을 쓰는 경우, 현재 환경이 올바른지 확인할 것

---

4. 추가 참고

• 파이썬 공식 pip 문서
• Anaconda 가상환경 관리