python 명령어가 안 될 때 해결 방법: PATH, App Execution Aliases, 설치 확인까지

파이썬을 설치했는데 python 명령어가 동작하지 않으면 대부분은 설치 문제라기보다 실행 경로 문제입니다. 이 글에서는 Windows와 macOS, Linux에서 python 또는 python3 명령어가 안 될 때 점검할 순서를 정리합니다.

Table of Contents

가장 먼저 확인할 증상

보통 아래와 같은 메시지가 보입니다.

python is not recognized as an internal or external command

또는

command not found: python3

이런 경우는 파이썬 실행 파일 경로를 시스템이 찾지 못하는 상황이 많습니다.

파이썬 설치 시 Add Python to PATH를 체크하지 않으면 명령어가 바로 동작하지 않을 수 있습니다.

Microsoft Store용 Python 별칭이 켜져 있으면 엉뚱한 동작을 할 수 있습니다. Windows 설정에서 App Execution Aliases를 확인해 python.exe, python3.exe 별칭을 조정해 보세요.

py --version

Windows에서는 python이 아니라 py가 먼저 동작하는 경우도 많습니다.

py --version
python --version
where python
where py

이 환경에서는 보통 python보다 python3를 먼저 확인해야 합니다.

python3 --version
which python3

python 명령어가 없는 것은 이상한 일이 아니라 기본 설정 차이인 경우가 많습니다.

시스템 환경 변수의 Path 항목에 Python 설치 폴더와 Scripts 폴더가 들어 있는지 확인합니다.

대표 예시는 아래와 같습니다.

C:\Users\사용자이름\AppData\Local\Programs\Python\Python312\
C:\Users\사용자이름\AppData\Local\Programs\Python\Python312\Scripts\

echo $PATH
which python3

설치 위치가 PATH에 없으면 쉘 설정 파일에서 경로를 추가해야 할 수 있습니다.

설치가 꼬였거나 여러 버전이 섞여 있다면 무작정 고치는 것보다 깔끔하게 재설치하는 편이 빠를 때도 있습니다. 특히 Windows에서는 기존 설치를 정리한 뒤 다시 설치하면서 PATH 옵션을 넣는 것이 안정적입니다.

다음 단계로는 파이썬 설치 경로 확인, VS Code에서 인터프리터 선택, 가상환경이 다른 버전을 가리킬 때 해결까지 이어서 점검하면 됩니다.