분명 설치했는데, 빌드하면 또 오류?

VSCode 터미널에서 pip install 라이브러리명을 입력해 설치도 잘 되고, import 해도 오류가 없는데, 막상 빌드를 하거나 다른 터미널에서 실행하려 하면 ModuleNotFoundError가 발생하곤 합니다. 처음엔 설치가 안 된 줄 알고 다시 설치해보지만, 계속 같은 에러가 반복됩니다.

이 문제는 VSCode에서 선택한 인터프리터와 터미널의 환경변수(PATH)가 서로 다른 파이썬을 바라보고 있기 때문에 발생합니다.

인터프리터와 환경변수는 다르게 동작합니다

VSCode의 Python 인터프리터 선택은 "이 파일을 어떤 파이썬으로 실행할까?"를 지정하는 겁니다. 내부적으로 .vscode/settings.json에 경로가 저장되고, 실행 시 해당 파이썬으로 스크립트를 돌립니다.

반면, 터미널에서 pip 명령어를 입력할 때는 환경변수(PATH)에 등록된 파이썬이 우선 적용됩니다. 윈도우 기준으로, PATH 설정에 따라 전혀 다른 파이썬(예: 시스템에 기본 설치된 것, Anaconda 등)이 실행될 수 있습니다.

해결 방법: 버전과 경로를 맞춰주세요

혼란을 줄이기 위해선 다음을 추천합니다

• VSCode에서 선택한 인터프리터 경로를 확인하세요. (Ctrl+Shift+P → Python: 인터프리터 선택)

• 그 경로가 pip와 연결되도록 윈도우 환경변수(PATH)에서 최신 버전을 가장 위로 수정하세요.
  • 예: C:\Users\내이름\AppData\Local\Programs\Python\Python39\Scripts\ 등
• 또는 VSCode 터미널에서도 python -m pip install 방식으로 동일한 인터프리터 기반으로 설치하세요.

정리

VSCode의 인터프리터는 "어떤 파이썬으로 실행할지"를 정하고, 터미널은 "어떤 환경에서 커맨드를 실행할지"를 결정합니다. 둘이 다르면 설치는 되었는데도 빌드나 실행이 안 되는 이상한 상황이 생기죠. 버전과 경로를 하나로 통일하면 이런 문제는 대부분 해결됩니다.