분명 파이썬을 설치했는데 python 명령어가 안 먹히면 당황하기 쉽습니다. 그런데 이런 문제는 설치 자체보다 PATH 설정, 실행 별칭, 다른 인터프리터 선택 때문에 생기는 경우가 더 많습니다.
이 글에서는 python 명령어가 안 될 때 가장 먼저 무엇을 확인하면 되는지, 헷갈리지 않게 순서대로 정리했습니다.
Table of Contents
가장 먼저 해볼 것
python --version
py --versionWindows에서는 python보다 py가 먼저 동작하는 경우가 많습니다. 두 명령어를 같이 확인해보는 편이 빠릅니다.
1. 파이썬이 정말 설치되어 있는지 확인
시작 메뉴에서 Python을 검색해보거나, 설치 폴더가 있는지 확인합니다. 설치가 아예 되어 있지 않다면 먼저 설치부터 다시 진행해야 합니다.
2. PATH 설정이 빠진 경우
설치는 되어 있는데 명령어가 안 된다면 가장 흔한 원인은 PATH입니다. Windows에서는 설치할 때 Add Python to PATH를 체크하지 않으면 이런 일이 자주 생깁니다.
이 경우에는 파이썬을 다시 설치하거나, 환경 변수에 설치 경로를 직접 추가하면 됩니다.
3. App Execution Aliases 문제
Windows에서는 Microsoft Store용 실행 별칭 때문에 python 명령어가 꼬이는 경우가 있습니다. 이런 경우 py는 되는데 python만 이상하게 동작하기도 합니다.
설정에서 App Execution Aliases를 확인해 끄면 해결되는 경우가 많습니다.
4. VS Code에서는 되는데 터미널에서 안 되는 경우
이때는 VS Code 안에서 선택된 인터프리터와 시스템 터미널의 인터프리터가 다를 가능성이 큽니다. 즉 VS Code는 다른 파이썬을 보고 있고, 터미널은 PATH에 잡힌 파이썬을 보고 있는 상황입니다.
5. 어떤 python이 실행되는지 확인
현재 어떤 실행 파일이 잡히는지 함께 보면 문제를 더 빨리 좁힐 수 있습니다.
where python
where pyPowerShell이라면 아래처럼 볼 수도 있습니다.
Get-Command python이 순서로 보면 빠릅니다
python --version확인py --version확인- 설치 여부 확인
- PATH 설정 확인
- App Execution Aliases 확인
where python으로 실제 경로 확인
정리
- 설치보다 PATH 문제인 경우가 많습니다
- Windows에서는
py가 먼저 되는 경우가 흔합니다 - App Execution Aliases 때문에
python명령이 꼬일 수 있습니다 - 실제 경로를 함께 보면 문제를 빠르게 좁힐 수 있습니다
함께 보면 좋은 글: