logo
IT/상품리뷰

Python 설치 후 pip 오류 해결 방법

Python 설치 후 pip 오류 해결 방법

처음 Python 설치를 하고 나서 제일 당황했던 게 코드가 아니라 pip였어요. 분명 설치는 잘 됐다고 나왔는데, 명령 프롬프트에 pip를 치면 인식이 안 된다고만 나오더라고요. 파이썬 문법 공부해 보려고 마음먹은 날이라 괜히 의욕이 확 꺾였어요. 인터넷 검색을 해 보니 다들 비슷한 벽을 한 번씩은 겪는 것 같아서, 저처럼 처음 Python 설치 후 막히는 분들께 제가 했던 방법을 정리해 보고 싶었어요.

Python 설치 경로와 PATH부터 확인하기

제가 쓰는 환경은 Windows라 먼저 Python 설치 경로부터 확인했어요. 기본값으로 설치하면 보통 C 드라이브 사용자 폴더 안 Program 폴더 쪽에 Python 버전별 폴더가 생기더라고요. 그 안에 Scripts 폴더를 열어 보면 pip.exe가 들어 있는데, 이 경로가 환경 변수에 안 들어가 있으면 pip 설치 문제가 거의 무조건 생겼어요. 해결은 단순했어요. 시스템 속성에서 환경 변수 열고 Path에 그 Scripts 경로를 그대로 추가해 줬습니다. 창을 전부 닫고 새로 cmd를 열어서 pip --version을 치면, 그제야 pip 버전 관리가 되는 걸 확인할 수 있었어요. 같은 Python 설치라고 해도 이 단계가 빠지면 pip 오류 해결이 안 되더라고요.

python -m pip로 먼저 살아나는지 체크

환경 변수 만지기 전에 급할 때는 python -m pip 방식을 먼저 써 봤어요. cmd에서 pip만 치면 오류가 나는데, python -m pip install 패키지명이라고 입력하면 바로 설치가 되는 경우가 많았어요. 이 방식은 시스템이 pip를 직접 못 찾아도 Python 실행 파일을 통해 호출하는 거라, Python 설치만 제대로 되어 있다면 꽤 안전하게 먹히더라고요. 특히 VS Code 내장 터미널에서도 같은 방식으로 쓰면 Python 환경 설정을 따로 깊게 몰라도 일단 패키지를 깔 수 있어서 편했어요. 여기서 설치가 되면 pip 설치 문제가 아니라 PATH 문제라는 걸 눈치챌 수 있었고, 그다음에야 마음 편히 환경 변수를 손댈 수 있었네요.

pip 재설치와 버전 업까지 한 번에 정리

가끔은 Scripts 폴더 안에 pip.exe가 아예 없던 적도 있었어요. 그때는 처음 Python 설치할 때 pip 옵션이 빠졌던 거라, 설치 파일을 다시 실행해서 Modify로 들어간 뒤 pip 체크를 켜고 다시 설치했어요. 그래도 찜찜해서 python -m pip install --upgrade pip 명령으로 최신 버전까지 올려 줬습니다. 이렇게 해 두면 나중에 라이브러리 깔 때 애매한 오류가 훨씬 덜 나요. pip 오류 해결 후에는 꼭 pip --version으로 확인해 두는 습관을 들였어요. 같은 PC에 Python을 여러 버전 깔아 두면 헷갈리기 쉬워서, 저는 가능하면 한 버전만 쓰고 가상환경으로 나눠 쓰는 쪽이 Python 환경 설정에도 더 편하다고 느꼈어요.

써보니 pip이 문제라기보다 사람이 설치 과정에서 뭔가 하나씩 놓치기 쉬운 구조라는 생각이 들었어요. 처음에는 왜 이렇게 꼬여 있나 싶었는데, 한 번 정리해 두니까 다음에 Python 설치를 새로 할 때도 훨씬 여유가 생기네요. 개인적으로는 새 PC를 세팅할 때 오늘 적은 순서 그대로 따라가 보면서, pip 버전 관리까지 깔끔하게 맞춰 두면 나중에 개발 시작할 때 잡생각이 덜해서 훨씬 편했어요.

#Python설치 #Python설치방법 #Python설치후pip오류해결방법 #pip오류해결 #pip설치문제 #Python환경설정 #pip버전관리 #윈도우Python설치 #VSCodePython설정 #pip명령어오류해결
광고 배너