본문 바로가기
프로그래밍언어/파이썬[Error]

[파이썬][Error] 056. ModuleNotFoundError - No module named 'external_lib'

by about_IT 2025. 5. 29.
728x90

ModuleNotFoundError: No module named 'external_lib' 오류는 파이썬에서 외부 라이브러리 또는 패키지를 임포트할 때 해당 모듈이 설치되어 있지 않거나, 현재 실행 환경에 등록되지 않았을 때 발생합니다. 이 오류는 주로 외부에서 가져온 코드나 다른 개발 환경에서 작동하던 코드를 실행할 때 자주 발생합니다.

패키지가 pip 또는 conda 환경에 설치되지 않았거나, 가상환경을 활성화하지 않고 실행했을 경우에도 해당 오류가 발생할 수 있습니다. 또한 외부 패키지를 설치했더라도 python 인터프리터 경로가 다르면 모듈을 인식하지 못합니다.

● 오류 발생 예시

import external_lib

해당 이름의 외부 라이브러리가 현재 환경에 설치되어 있지 않으면 오류가 발생합니다.

ModuleNotFoundError: No module named 'external_lib'

● 해결 방법

  • pip install external_lib로 패키지 설치
  • 가상환경(venv, conda 등)이 활성화되어 있는지 확인
  • pip list 또는 conda list로 설치 여부 확인
  • sys.executable로 현재 인터프리터 경로 확인

● 예시 코드

# 예시: requests 모듈이 없는 경우
try:
    import requests
except ModuleNotFoundError:
    print("requests 모듈이 설치되지 않았습니다.")

● 자주 하는 실수

  • 패키지를 설치하지 않고 import 시도
  • 다른 환경(예: Jupyter, IDE, CLI)의 Python 경로 차이 인식 부족
  • 설치된 패키지 이름과 import 경로 혼동

● 결론

ModuleNotFoundError - No module named 'external_lib' 오류는 해당 패키지가 설치되지 않았거나 현재 환경에서 인식할 수 없을 때 발생합니다. pip 설치 여부, 환경 활성화, 인터프리터 경로 등을 명확히 점검하여 해결할 수 있습니다.

728x90