Python ModuleNotFoundError 해결 방법 — 원인부터 완벽 해결까지
저도 처음에 pip install 을 분명히 했는데 ModuleNotFoundError 가 계속 나와서 한참을 헤맸습니다. 알고 보니 가상환경이 활성화가 안 된 상태에서 설치했던 게 문제였습니다. 가상환경을 사용 중이라면 패키지를 설치하거나 코드를 실행하기 전에 반드시 가상환경이 활성화되었는지 확인해야 합니다. 아래의 절차를 통해 현재 환경을 점검해 보세요. Python 을 배우다 보면 누구나 한 번은 마주치는 오류가 있습니다. 바로 ModuleNotFoundError: No module named 'XXX' 입니다. vscode 에서 코드를 실행하는 순간 이 빨간 글씨가 등장하면 당황스럽지만, 사실 이 오류는 원인이 명확하고 해결 방법도 분명합니다. 이 글에서는 ModuleNotFoundError 가 발생하는 다섯 가지 원인과 상황별 해결법을 단계별로 정리해 드리겠습니다. ModuleNotFoundError란 무엇인가 — 택배 주소를 찾을 수 없는 상황 오류의 정체 ModuleNotFoundError 는 Python 이 import 문으로 모듈을 불러오려 했지만 해당 모듈을 찾지 못했을 때 발생합니다. 아래처럼 생긴 오류 메시지가 바로 그것입니다. ModuleNotFoundError: No module named 'pandas' 택배에 비유하면 이렇습니다. import pandas 는 "판다스라는 이름의 택배를 가져와줘"라는 요청입니다. 그런데 창고(Python 환경)에 그 택배가 없으면 "해당 주소로 배달된 물건이 없습니다"라는 메시지가 뜨는 것입니다. 해결책은 단순합니다. 창고에 물건을 채워 넣거나(설치), 올바른 창고를 열거나(환경 확인), 주소를 정확히 쓰거나(경로 설정) 하면 됩니다. 오류가 발생하는 다섯 가지 상황 원인 1 — 라이브러리를 아예 설치하지 않은 경우 원인 2 — 가상환경이 활성화되지 않은 상태에서 설치한 경우 원인 3 — VS Code의 ...