Windows에서 Python 환경변수 오류 해결하기 | Python --version 안될때

사진: Unsplash의Rubaitul Azad

  # Windows에서 Python 환경변수 오류 해결하기

안녕하세요! 오늘은 Windows에서 python --version 명령어가 실행되지 않는 문제를 해결하는 방법에 대해 알아보겠습니다.

문제 상황

Windows에서 Python을 설치했는데도 명령 프롬프트에서 다음과 같은 오류가 발생하는 경우가 있습니다:

먼저 bash에서 where python 명령어로 Python이 설치된 경로를 확인해보세요:

C:\Users\[사용자이름]\AppData\Local\Microsoft\WindowsApps\python.exe
C:\Python39\python.exe

위와 같이 WindowsApps 경로가 먼저 나오는 경우 문제가 발생할 수 있습니다.

이때 python --version을 실행하면 다음과 같이 'Python'이라고만 출력되고 버전 정보가 나오지 않습니다:

Python

정상적으로 설치된 경우라면 아래와 같이 버전 정보가 함께 출력되어야 합니다:

Python 3.9.7

특히 Path 환경변수에 C:\Users\[사용자이름]\AppData\Local\Microsoft\WindowsApps가 있는 경우 이런 문제가 자주 발생합니다.

아래와 같이 출력 되는 경우는 Python 설치가 안되었거나 환경변수가 설정이 안되었을 경우 출력됩니다. 이 경우에는 환경변수 설정을 해주시면 바로 해결됩니다.

'python'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.

원인

이 문제는 Windows Store의 Python 앱과 직접 설치한 Python이 충돌하면서 발생합니다. WindowsApps 경로가 Python 설치 경로보다 우선순위가 높아서 생기는 현상입니다.

해결 방법

1. 환경 변수 편집하기

1. 윈도우 검색창에 "환경 변수"를 입력하고 "시스템 환경 변수 편집" 선택
2. "환경 변수(N)" 버튼 클릭
3. "사용자 변수" 또는 "시스템 변수"에서 "Path" 선택
4. "편집" 버튼 클릭

2. WindowsApps 경로 제거 및 Python 경로 상향 조정

1. C:\Users\[사용자이름]\AppData\Local\Microsoft\WindowsApps 항목을 찾아 제거
2. Python 설치 경로를 목록 최상단으로 이동
   • 일반적인 Python 설치 경로:
     • C:\Python3X
     • C:\Users\[사용자이름]\AppData\Local\Programs\Python\Python3X
     • C:\Users\[사용자이름]\AppData\Local\Programs\Python\Python3X\Scripts
     • C:\Program Files\Python3X

3. 변경사항 적용

1. "확인" 버튼을 눌러 모든 창 닫기
2. 명령 프롬프트를 새로 실행
3. python --version 명령어로 정상 작동 확인

추가 팁

• Python 설치 시 "Add Python to PATH" 옵션을 체크하면 이런 문제를 예방할 수 있습니다.
• 여러 버전의 Python을 사용할 경우, Python Launcher (py 명령어)를 사용하는 것이 좋습니다.

문제가 지속될 경우

1. Python을 완전히 제거
2. WindowsApps의 Python 앱도 제거
3. Python을 새로 설치 ("Add Python to PATH" 옵션 체크)
4. 재부팅

이렇게 하면 대부분의 경우 문제가 해결됩니다.

도움이 되었기를 바랍니다!