문제 상황
Visual Studio Code에서 python 가상 환경을 설치해 Django를 실행시키려했으나 터미널에 아래와 같은 에러가 뜬다...
Error: Command '['C:\\Users\\venv\\Scripts\\python.exe', '-m', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1.
원인 및 해결 방법
1차 해결과정
구글링해도 정확한 해결 방법이 나오지 않아서 Chat스승님께 여쭤봄...
아래는 Chat GPT 답변!!
이 에러는 Python 가상환경을 만들 때 ensurepip 모듈을 통해 pip를 설치하려고 했지만, 실패한 경우 발생할 수 있습니다. 몇 가지 해결 방법을 시도해 볼 수 있습니다.
1. Python 재설치
Python이 제대로 설치되지 않았을 가능성이 있습니다. Python을 삭제한 후, 다시 설치하고, 설치 시 "Add Python to PATH" 옵션이 체크되어 있는지 확인하세요.
2. Visual Studio Code 재설정
VS Code에서 Python 관련 설정이 꼬였을 가능성도 있으므로, VS Code를 다시 시작하거나 Python 확장팩을 제거 후 재설치해 보세요.
수동으로 pip 설치
명령어로 직접 pip를 설치할 수 있습니다. 아래 명령어를 시도해 보세요.python -m ensurepip --default-pip python -m pip install --upgrade pip
3. 환경 변수 설정 확인
PATH 환경 변수에 Python과 관련된 경로가 올바르게 추가되어 있는지 확인하세요. 경로: C:\Users{Your_Username}\AppData\Local\Programs\Python\Python{Version}\Scripts\
Python 설치 경로도 확인 필요.
4. 관리자 권한으로 실행
가상환경을 만들 때 권한 문제일 수 있습니다. 터미널이나 명령 프롬프트를 관리자 권한으로 실행한 후 다시 시도해 보세요.
나의 경우 '3. 환경 변수 설정 확인'이 의심되어 이부분을 다시 실행해보았다.
환경 변수 설정은 이 링크를 참고하였다.
처음에는 가상환경 설치하는 부분까지 에러없이 실행되다가 pip install 명령어에서 다시 에러가 떠서 확인해보니 이전 버전의 Python 3.8.3으로 명령어가 실행되고 있었다. 버전이 낮아서 라이브러리를 설치하려다가 에러가 난 것이었다.
2차 해결과정
내가 설치한 파이썬은 Python 3.13.0 버전인데 가상환경에 설치하려는 파이썬이 낮은 버전이라서 에러가 뜬 것이었다!!!!
anaconda에 깔려있던 3.8.3 버전만 지우면 되는 줄 알았는데 PyCharm 인터프리터로 설정해둔 pypy에 있던 3.10.14 버전을 까먹고 있었다...
파이참 인터프리터 변경은 이 링크를 참고하였다.
인터프리터 변경 중에 파이썬이 깔려있는 AppData 디렉토리가 나타나지 않아서 애를 먹었는데 오른쪽 위에 눈모양 아이콘을 클릭하면 숨김 파일까지 모두 확인할 수 있다!
3차 해결과정
구버전 삭제후 3.13.0 버전으로 다시 VSC에서 가상환경을 설치해봤는데 여기까지는 에러가 뜨지않았다.
하지만....
pip install 과정에서 생전 처음보는 에러 메시지가 떠서...
그냥 Python을 3.10 버전으로 낮춰서 설치하기로 단념했다.......
최신 버전일수록 가상환경 설정 시 에러가 뜰 확률이 높다고카더라... 왜 그런진 모르게따...그냥 받아들여야겠다......글쿤....
pypy에 있던 3.10.14과 Python 3.13.0을 삭제하고 공홈에 남아있는 가장 최신 3.10.x인 Python 3.10.11을 설치하니 해결완!
3줄 요약
- VSC에서 가상 환경(venv)과 기본 환경의 Python 버전이 일치해야 가상 환경이 실행됨
- (뇌피셜) VSC는 Python Interpreter를 가장 최상단 디렉토리에 있는 Python 버전을 global로 자동 설정하는 것 같다.
(뇌피셜의 근거) 가장 낮은 버전으로 자동 설정해주는 줄 알고,C:\pypy3.10-v7.3에 있던 3.10.14 버전을 냅두고C:\Users\사용자명\AppData\Local\Programs\Python에 3.10.11을 다운 받았는데 VSC Interperter에는 3.10.14가 여전히 global로 잡혀있었다.
(pypy 디렉토리 삭제한 뒤에는 3.10.11이 global로 잡혔음)
