잘 되던 파이썬 모듈이 안 불러와질 때 : module not found

이다언·2025년 1월 21일

실행 환경

  • 원격 리눅스 컴퓨터에, 비쥬얼스튜디오코드(VSC)에서 설치한 Remote Explorer extension으로 접속해서 사용 중

문제 증상

  • 잘 되던 파이썬 라이브러리들이 일시에 갑자기 모두 설치가 안 된 것으로 나온다
  • 없다는 모듈들을 다시 설치를 해도 module not found가 나온다
  • 이전에는 ctrl+shift+p에서 Python Interpreter에서 여러가지 파이썬 인터프리터들을 선택하다보면 증상이 해결되었다.
  • 하지만 이제는 직접 선택을 하여도 계속module이 없다고 나온다.

문제 해결 실마리

  • VSC 우측하단에 명시된 버전은 파이썬 인터프리터 버전인데, Python Interpreter를 다른 버전을 선택하여도 우측 하단 버전은 변하지 않는다.
  • VSC 우측 하단에 버전이, Terminal에서 python --version 할 때 나오는 버전(실제 실행환경)과 불일치한다
  • 확인을 해보니, VSC 우측하단 버전은 원격 컴퓨터 파이썬 경로가 아닌, 로컬 파이썬 환경 경로였다.

원인

  • 터미널에서 실제 파이썬 파일들 실행하는 파이썬 실행환경(위치)이
    VSC에서 설정된 기본 파이썬 실행환경(위치)하고 일치하지 않는다.
  • VSC에 설정된 기본 파이썬 실행환경이 갑자기 원격에서 로컬로 변경되고 변경이 되지 않는다.

대책

  1. 컴퓨터를 몇일동안 안 끄고 살았더니 VSC가 정신을 못 차렸다. 작업파일들 저장하고 컴퓨터를 껐다 켰다.
  2. settings.json에 기본 파이썬 인터프리터 경로가 로컬경로인 C:~ 되어있어서, 강제로 원격컴퓨터 파이썬 실행환경 경로로 바꿔줬다.
  3. 그리고 Python Interpreter를 직접 골라줬다.
    • Ctrl+Shift+P 혹은 VSC 우측 하단에 파이썬 버전명 클릭
  4. 그리고 VSC를 껐다 켰다.
  5. 드디어 우측 하단 버전이 원격컴퓨터 파이썬 환경으로 변동되었고,
  6. 안 불러와지던 모듈들은 문제없이 불러와졌다.

요약

우측 하단의 Python Interpreter는 VSCode가 현재 사용하는 Python 실행 환경을 나타냅니다. 만약 원하는 환경이 선택되지 않았다면, Python Interpreter를 수동으로 설정하여 터미널과 동기화하세요.

VSC 불안정성

  • VSC 불안정성 때문인지 갑자기 되었다가 다시 안 되었다가 한다
  • 안 될 때는 무슨 방법을 써도 안 된다

작업폴더 변경해서 파일 열었더니

  • 같은 파일도 작업 중이던 깃폴더에서 아니고
  • 그 외 폴더에 있는 파일 열었더니 다른 파이썬 인터프리터가 되면서 안 되는 것 같다.
profile
AI 클라우드 웹개발자

0개의 댓글