파이썬 설치 방법과 'python 인식 안됨' 해결 (윈도우)
윈도우에서 파이썬은 공식 설치 파일을 실행한 뒤 첫 화면에서 "Add python.exe to PATH"에 체크하고 설치하면 됩니다. 설치 후에도 'python 인식 안됨' 오류가 나거나 명령어를 입력했는데 Microsoft Store가 열린다면, 원인은 대부분 PATH 누락이거나 윈도우의 앱 실행 별칭이 python 명령을 가로챈 것입니다.
이 글에서는 설치 순서, 설치 확인 방법, 증상별 원인 구분, 그리고 초보자가 가장 많이 막히는 MS 스토어 별칭 문제까지 순서대로 정리합니다.
설치 방법 고르기: 공식 설치 파일, MS 스토어, winget
윈도우에서 파이썬을 설치하는 방법은 크게 세 가지입니다. 처음이라면 공식 설치 파일을 권합니다. 설치 경로와 PATH 설정을 직접 확인할 수 있어서 문제가 생겨도 원인을 찾기 쉽습니다.
| 방법 | 장점 | 주의할 점 |
|---|---|---|
| python.org 공식 설치 파일 | 가장 널리 쓰이는 방식, 자료가 많음 | PATH 체크박스를 직접 선택해야 함 |
| Microsoft Store | 클릭 몇 번으로 설치, 자동 업데이트 | 일부 폴더 접근이나 도구 호환에 제약이 있을 수 있음 |
| winget(명령어 설치) | 터미널에서 한 줄로 설치 | 패키지 이름에 버전이 들어가 있어 검색 후 설치해야 함 |
설치 파일과 라이선스 정보는 파이썬 다운로드 안내 페이지에서 확인할 수 있습니다. 파이썬은 무료입니다. 최신 버전 번호와 설치 방식은 바뀔 수 있으니 공식 사이트에서 최신 정보를 확인하세요.
공식 설치 파일로 파이썬 설치하는 순서
- 64비트 Windows용 설치 파일(installer)을 내려받습니다. 대부분의 PC는 64비트입니다.
- 설치 파일을 실행합니다.
- 첫 화면 아래쪽의 "Add python.exe to PATH"에 반드시 체크합니다. 버전에 따라 "Add Python 3.x to PATH"로 표시되기도 합니다.
- Install Now를 누릅니다. 설치 위치를 바꾸고 싶다면 Customize installation을 선택합니다.
- 마지막 화면에 "Disable path length limit" 버튼이 보이면 눌러 두는 것이 좋습니다. 긴 경로 때문에 생기는 오류를 줄여 줍니다.
- 설치가 끝나면 열려 있던 명령 프롬프트, PowerShell, VS Code를 모두 닫고 새로 엽니다. 이미 열려 있던 창은 바뀐 PATH를 읽지 못합니다.
winget을 쓴다면 터미널에서 winget search Python.Python으로 패키지 이름을 확인한 뒤 winget install 뒤에 해당 이름을 붙여 설치합니다.
설치가 잘 됐는지 확인하는 방법
새로 연 명령 프롬프트에서 아래 명령어를 차례로 입력합니다.
python --version: 설치한 버전이 나오면 정상입니다.py --version: 공식 설치 파일에 포함된 py 런처로 확인합니다. 이건 되는데 python만 안 된다면 PATH 문제일 가능성이 큽니다.where python: 실제로 어떤 python.exe가 실행되는지 경로 목록을 보여 줍니다. PowerShell에서는where.exe python으로 입력해야 합니다.
where python 결과의 첫 줄이 실제로 실행되는 파일입니다. 첫 줄이 ...\AppData\Local\Microsoft\WindowsApps\python.exe라면 설치한 파이썬이 아니라 스토어 별칭이 실행되고 있다는 뜻입니다.
'python 인식 안됨' 증상별 원인
| 증상 | 원인 | 해결 |
|---|---|---|
| "'python'은(는) 내부 또는 외부 명령... 이 아닙니다" | PATH에 파이썬 경로가 없음 | PATH 설정(아래 섹션) |
| PowerShell에서 "용어가 cmdlet... 으로 인식되지 않습니다" | PATH 누락 또는 창을 다시 열지 않음 | 새 창에서 재확인 후 PATH 설정 |
| python 입력 시 Microsoft Store가 열림 | 앱 실행 별칭이 가로챔 | 별칭 끄기 |
| 아무 출력 없이 끝나거나 "Python"만 출력됨 | 앱 실행 별칭이 가로챔 | 별칭 끄기 |
| py는 되는데 python은 안 됨 | 설치 시 PATH 체크 누락 | 설치 파일 Modify 또는 수동 PATH 추가 |
MS 스토어 별칭이 python을 가로채는 문제 해결
윈도우 10과 11에는 파이썬을 설치하지 않은 사용자를 스토어로 안내하려고 python.exe, python3.exe라는 가짜 실행 파일(앱 실행 별칭)이 들어 있습니다. 이 별칭이 켜져 있고 PATH에서 설치한 파이썬보다 앞에 있으면, 파이썬을 제대로 설치해도 python을 입력할 때 스토어가 열리거나 아무 반응이 없습니다.
- 시작 메뉴 검색창에 "앱 실행 별칭"을 입력해 설정 화면을 엽니다. 윈도우 11은 보통 설정의 앱 → 고급 앱 설정 아래에 있습니다. 메뉴 위치는 윈도우 버전에 따라 조금씩 다릅니다.
- 목록에서 "앱 설치 관리자 python.exe"와 "앱 설치 관리자 python3.exe"를 찾습니다.
- 두 항목을 모두 끔으로 바꿉니다.
- 터미널을 새로 열고
where python으로 첫 줄이 설치한 파이썬 경로인지 확인합니다.
별칭을 끈 뒤 "인식되지 않습니다" 오류로 바뀌었다면, 원래부터 PATH가 비어 있었던 것입니다. 이 경우 다음 섹션대로 PATH를 설정합니다. 스토어판 파이썬을 설치해서 쓰는 경우라면 이 별칭이 실제 파이썬을 실행하는 통로이므로 끄지 않습니다.
python PATH 설정하는 방법
방법 1: 설치 파일로 다시 설정
- 파이썬 설치 파일을 다시 실행하고 Modify를 선택합니다.
- Optional Features 화면에서 Next를 누릅니다.
- Advanced Options에서 "Add Python to environment variables"에 체크하고 Install을 누릅니다.
설치 파일이 없다면 같은 버전을 다시 내려받거나 윈도우의 앱 목록에서 Python 항목의 수정 기능을 이용합니다.
방법 2: 환경 변수 직접 편집
- 먼저 파이썬 설치 경로를 확인합니다. 기본 설치 시 보통
C:\Users\사용자이름\AppData\Local\Programs\Python\Python3xx형태입니다.py -c "import sys; print(sys.executable)"로 정확한 경로를 알 수 있습니다. - 시작 메뉴에서 "계정의 환경 변수 편집"을 검색해 엽니다.
- 사용자 변수의 Path를 선택하고 편집을 누릅니다.
- 새로 만들기로 두 줄을 추가합니다. 파이썬 폴더(
...\Python3xx\)와 그 아래Scripts폴더(...\Python3xx\Scripts\)입니다. - 추가한 두 줄을 위로 이동해
%USERPROFILE%\AppData\Local\Microsoft\WindowsApps보다 위에 둡니다. 이 순서가 뒤집히면 별칭이 다시 우선 실행됩니다. - 확인을 눌러 모두 닫고, 터미널을 새로 열어
python --version을 확인합니다.
pip 인식 안됨도 같은 원리입니다
python은 되는데 pip만 인식되지 않는다면 Scripts 폴더가 PATH에 빠진 경우가 대부분입니다. 위 방법 2의 4번처럼 Scripts 경로를 추가하면 됩니다. 급하게 쓰려면 python -m pip install 패키지이름처럼 python을 거쳐 실행해도 됩니다. 이 방식은 여러 버전이 설치돼 있을 때 어느 파이썬에 패키지가 설치되는지도 분명해서 평소에도 권장됩니다.
자주 묻는 질문
파이썬을 여러 버전 설치해도 되나요?
됩니다. 다만 python 명령은 PATH에서 먼저 찾은 버전 하나만 실행합니다. 버전을 골라 쓰려면 py 런처로 py -3.12처럼 버전을 지정하고, py --list로 설치된 버전 목록을 확인합니다.
VS Code 터미널에서만 python이 인식되지 않아요.
PATH를 바꾸기 전에 열어 둔 VS Code는 예전 환경 변수를 그대로 씁니다. VS Code를 완전히 종료한 뒤 다시 실행하세요. 그래도 안 되면 PC를 재시작해 봅니다.
python3 명령어는 윈도우에서 안 쓰나요?
공식 설치 파일로 설치하면 윈도우에서는 보통 python과 py를 씁니다. python3를 입력했을 때 스토어가 열린다면 python3.exe 별칭 때문이니 앱 실행 별칭에서 끄면 됩니다.
시스템 변수와 사용자 변수 중 어디에 넣어야 하나요?
본인 계정에서만 쓴다면 사용자 변수 Path에 넣으면 충분합니다. PC의 모든 사용자가 써야 할 때만 관리자 권한으로 시스템 변수에 추가합니다.
정리
윈도우 파이썬 설치에서 가장 중요한 것은 설치 첫 화면의 "Add python.exe to PATH" 체크입니다. 설치 후 python이 인식되지 않으면 새 터미널에서 where python으로 실제 실행 경로부터 확인하세요. 첫 줄이 WindowsApps 경로라면 앱 실행 별칭을 끄고, 아예 찾지 못한다면 설치 파일의 Modify나 환경 변수 편집으로 파이썬 폴더와 Scripts 폴더를 PATH에 추가하면 됩니다.