macOS zsh: command not found: python 해결법: Homebrew와 python3 설정

macOS 터미널에서 python을 입력했을 때 zsh: command not found: python 오류가 나오면 Python이 설치되지 않았거나, macOS가 더 이상 python 명령을 기본 제공하지 않는 상황일 가능성이 큽니다.

원인

macOS Monterey 12.3 이후 Apple은 기본 Python 2 제공을 중단했습니다. 따라서 새 Mac이나 업데이트된 환경에서는 python 대신 python3를 직접 설치하고 사용해야 합니다.

해결 방법 1. Homebrew로 Python 설치

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install python

Apple Silicon(M1/M2/M3) 경로 설정

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile

Intel Mac 경로 설정

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile

설치 확인

python3 --version
pip3 --version

python 명령어를 꼭 쓰고 싶다면

가능하면 python3를 그대로 쓰는 것을 추천합니다. 그래도 기존 스크립트 때문에 python 명령이 필요하다면 alias를 추가할 수 있습니다.

echo 'alias python=python3' >> ~/.zshrc
source ~/.zshrc

그래도 해결되지 않는다면

  • 터미널을 완전히 종료한 뒤 다시 실행합니다.
  • which python3로 실제 설치 경로를 확인합니다.
  • Homebrew가 제대로 설치됐는지 brew doctor를 실행합니다.

FAQ

python 대신 python3를 써도 되나요?

네. 최신 macOS에서는 python3 사용이 권장됩니다. 새 프로젝트라면 python3와 pip3를 기준으로 설정하는 것이 안전합니다.

alias 설정은 필수인가요?

필수는 아닙니다. 기존 문서나 스크립트가 python 명령을 요구할 때만 alias를 추가하면 됩니다.

Post Views: 4