코쟁이

🎯 타겟 독자: Python 3.13으로 마이그레이션을 진행 중인 백엔드 개발자, 라이브러리 설치 후에도 모듈을 찾을 수 없다는 오류에 직면한 주니어 엔지니어. 📝 요약: pip install 로 패키지를 설치했음에도 ModuleNotFoundError 가 발생하는 주된 원인은 '인터프리터 실행 경로와 패키지 설치 경로의 불일치' 입니다. 본 글에서는 2026년 기준 최신 Python 3.13 환경에서 sys.path 를 통해 원인을 진단하고, 오염된 개발 환경을 venv (가상환경)로 완벽하게 격리 및 재구축하는 표준 절차를 다룹니다. 1. 문제 정의: 설치했는데 왜 없다고 나오는가? Python 개발을 하다 보면 가장 흔하게, 그러나 가장 당혹스럽게 마주하는 오류가 바로 ModuleNotFoundError: No module named 'x' 입니다. 특히 2026년 현재 안정화된 Python 3.13 버전으로 프로젝트를 업그레이드하거나, 여러 버전의 파이썬(3.11, 3.12, 3.13)이 공존하는 로컬 머신에서 이 문제는 빈번하게 발생합니다. 많은 개발자가 이 오류를 마주했을 때 단순히 pip install [패키지명] 을 반복 입력하거나, 무작정 IDE를 재시작하는 경향이 있습니다. 하지만 터미널에서 Requirement already satisfied 라는 메시지가 뜸에도 불구하고 코드 실행 시 에러가 지속된다면, 이는 단순 설치 문제가 아닌 '환경 참조(Path Reference)' 의 문제입니다. 즉, 당신이 명령어를 입력하는 터미널(Shell)이 바라보는 파이썬과, 코드를 실행하는 인터프리터가 서로 다른 곳을 보고 있다는 뜻입니다. 2. 기술적 원인 분석: sys.path와 인터프리터의 괴리 Python...