[Python/pandas] ModuleNotFoundError: No module named 'pandas' (VScode 환경)

에러 메시지

ModuleNotFoundError: No module named 'pandas'

 

한달전까지만 해도 VScode에서 잘 실행되었던 파이썬 소스코드가 실행되지 않는다.

판다스 모듈을 갑자기 찾을 수 없다고 한다.

 

파이썬 버전이 3.13 버전으로 새로 설치되면서 발생한 문제같다.

 

예전에는 파이썬 3.10 버전으로 모듈 설치 및 환경을 조성했었는데 3.13 버전으로 새롭게 설치되면서 모듈을 다시 깔아야 하나보다.

 

첨부된 이미지의 맨 위 소스코드를 보면 파이썬 실행 경로가 나오는데, 3.13 버전인 것을 알 수 있다.

PS C:\work\python> & C:/Python313/python.exe "c:/work/python/**쿠폰 난수번호 생성/*coupon.py"

---

1. 원인

// 파이썬 버전 확인
C:/Python313/python.exe --version
// 판다스 설치 여부 확인
C:/Python313/python.exe -m pip show pandas

 

파이썬 버전은 3.13으로 바뀐 것이 확인되는데, 판다스 모듈은 보이지 않는다.

 

2. 해결

VScode 터미널 내 판다스를 설치했다.

C:/Python313/python.exe -m pip show pandas

 

성공적으로 모든 파이썬 필수 패키지가 설치되었다. (pandas, openpyxl 외 종속 패키지 포함)

 

+ path 경고 관련해서 아래와 같은 메시지가 노출되었다.

WARNING: The scripts f2py.exe and numpy-config.exe are installed in '...Python313\Scripts' which is not on PATH.

 

해당 경고는 numpy 관련 명령어가 터미널에서 직접 실행되지 않을 수 있다는 뜻이다.

현재 내가 실행해야 하는 쿠폰 생성 스크립트와는 무관해서 지금 당장은 무시해도 되지만 사람일 모르는거니..

환경 변수 path에 문제 된 경로를 추가하기로 한다.

 

▶️환경변수 실행 방법

Window + R 키 (윈도우 환경) > 'sysdm.cpl' 입력 후 확인

고급 > 환경변수

시스템 변수 > Path > 편집

새로 만들기 > 스크립트 경로 추가 > 확인

모두 확인 후 재부팅 또는 명령 프롬프트 재시작

C:\Python313\Scripts\
C:\Python313\

 

이미 환경변수 Path에 위와 같은 경로들이 추가되어 있음에도 불구하고

문제되었던 경로를 추가하는 이유는 'Python 본체(python.exe)와 그에 딸린 스크립트 도구들(pip.exe 등)을 커맨드라인에서 쓸 수 있게 설정하기 위함'이다.

 

path 경고와 관련된 경로는 사용자 모드(user install)로 설치된 pip 패키지들의 실행 파일이 위치하는 곳이다.

 

이 경로에 설치되는 이유는 설치 중 다음 메시지에서 확인할 수 있다.

Defaulting to user installation because normal site-packages is not writeable

▶ 즉, 일반 시스템 경로(C:\Python313\Lib\site-packages)에 쓰기 권한이 없어서 사용자 전용 경로에 설치된 것이다.

 

[결론]

실행하려는 패키지들이 자체 실행 도구(f2py, jupyter, streamlit 등)를 제공하거나,

향후 명령어 충돌 방지를 위해서 path 경고에서 알려준 경로를 환경변수 path에 추가하는 것이 안전하다.

 

반드시 필요한 설정은 아니지만, 경고 없이 명령어들이 잘 동작하려면 path에 추가하는 편이 좋다.

특히 jupyther, streamlit, pytest, bloack, pipenv와 같은 CLI 도구들을 사용할 때 도움이 된다고 한다.

 

3. 설치 후 실행

C:/Python313/python.exe "c:/work/python/**쿠폰 난수번호 생성/*coupon.py"

 

다음 명령어로 실행하니 이제야 실행이 잘 된다.