파이썬 설치 오류·설치 안됨 해결
'python' is not recognized as an internal or external command, operable program or batch file. Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings > Manage App Execution Aliases.
이런 증상일 때
파이썬을 설치했는데도 터미널에서 python --version 을 치면 "is not recognized"(윈도우 cmd) 또는 "command not found: python"(맥 zsh)이 뜨거나, 윈도우에서 빈 줄만 나오고 Microsoft Store 창이 열립니다. 설치 마법사가 중간에 멈추거나, pip install 단계에서 UnicodeDecodeError 로 깨지는 경우도 같은 "설치 안됨" 증상으로 묶입니다. 대부분 바이너리는 디스크에 있지만 셸이 그 경로를 모르는 상태입니다.
원인
- 윈도우 설치 마법사 첫 화면의 'Add python.exe to PATH' 체크박스를 빼먹어 python.exe 가 PATH 에 없음
- 윈도우 10/11 의 앱 실행 별칭(App Execution Aliases)이 python.exe 를 가로채 Microsoft Store 로 보냄 — 파이썬 3.12 부터 Store 설치본의 별칭이 기본 비활성
- macOS Monterey 12.3 부터 /usr/bin/python(파이썬 2.7)이 제거돼 python 명령 자체가 없음 — 이제는 python3 만 존재
- PATH 를 바꾼 뒤 기존 터미널·에디터를 닫지 않아 변경된 PATH 가 적용 안 됨
- 윈도우 사용자명·설치 경로에 한글이 들어가 cp949 환경에서 pip 가 UTF-8 메타데이터를 읽다 UnicodeDecodeError 로 설치 실패
해결 방법
공식 installer 를 다시 실행하면 'Modify' 화면이 나옵니다. 설치 첫 화면 하단의 'Add python.exe to PATH' 를 체크한 뒤 설치하고, 모든 터미널을 닫았다 새로 엽니다. 설치본을 다 지우지 않아도 PATH 만 다시 등록됩니다. 등록 확인은 아래 명령으로 합니다.
python --version
py --version # py 가 되고 python 이 안 되면 PATH 만 빠진 상태python 을 쳤을 때 빈 줄만 나오거나 Store 창이 뜨면 앱 실행 별칭이 가로챈 것입니다. 시작 메뉴에서 '앱 실행 별칭 관리'(Manage App Execution Aliases)를 열어 python.exe·python3.exe 항목을 끄세요. 파이썬 3.12 부터 Store 설치본은 이 별칭이 기본 꺼져 있어, 정식 설치본 PATH 등록과 병행해야 합니다.
# 설정 위치: 설정 > 앱 > 고급 앱 설정 > 앱 실행 별칭
# python.exe / python3.exe 토글 OFF
where python # 끈 뒤 실제 설치 경로가 잡히는지 확인재설치 없이 고치려면 환경 변수 PATH 에 파이썬 폴더와 Scripts 폴더 두 개를 직접 추가합니다. 버전 폴더명(Python313 등)은 실제 설치 경로에 맞춥니다. 등록 후 반드시 새 터미널을 열어야 적용됩니다.
# PowerShell 에서 현재 사용자 PATH 에 추가 (경로는 실제 설치 위치로)
setx PATH "$env:PATH;%LocalAppData%\Programs\Python\Python313;%LocalAppData%\Programs\Python\Python313\Scripts"macOS 12.3 부터 시스템 python 2 가 제거돼 python 명령은 없습니다. Homebrew 나 pyenv 로 설치한 뒤 python3 를 쓰면 됩니다. 버전을 바꿔 쓰려면 pyenv 가 깔끔합니다 — pyenv 는 처음엔 기본 버전을 안 잡으니 global 설정이 필요합니다.
brew install python # 또는: brew install pyenv
pyenv install 3.13.0
pyenv global 3.13.0 # 기본 버전 지정(이게 빠지면 command not found)
python3 --versionpyenv 를 깔았는데도 python 이 안 잡히면 셸 시작 파일에 초기화 줄이 빠진 것입니다. ~/.zshrc 에 아래를 추가하고 셸을 새로 띄우세요.
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
exec zsh # 새 셸 적용윈도우 사용자명이 한글이면 설치는 끝나도 pip install 이 cp949 로 UTF-8 메타데이터를 읽다 UnicodeDecodeError 로 깨집니다. 시스템 전역 UTF-8(베타) 을 켜거나, 임시로 PYTHONUTF8=1 을 줘서 우회합니다. 근본 해결은 영문 경로에 재설치하는 것입니다.
# cmd 에서 임시 우회
set PYTHONUTF8=1
python -m pip install <패키지>
# 영구 적용: 설정 > 시간 및 언어 > 언어 > 관리자 언어 설정 > "Beta: 세계 언어 지원에 Unicode UTF-8 사용" 체크