macOS에서 'zsh: command not found: python' 에러 해결하기

macOS Monterey 이후 버전에서 터미널에서 python 명령어를 입력하면 다음과 같은 에러가 발생할 수 있습니다.

zsh: command not found: python

이 에러의 원인은 macOS Monterey(12.3 버전 이후)부터 기본 제공되던 Python 2가 완전히 제거되었기 때문입니다. 특히, 제가 사용하는 MacBook M1에서는 추가적인 설정이 필요합니다. 이제 사용자가 직접 Python을 설치해야 합니다.

이 글에서는 간단히 해결하는 방법을 안내드립니다.

---

📌 해결 방법

Step 1. Homebrew 설치하기 (이미 설치된 경우 생략 가능)

먼저 터미널에서 다음 명령어를 입력해 Homebrew를 설치하세요.

• MacBook M1 및 Apple Silicon 전용 설치 명령어:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile

Step 2. Python 설치하기

다음 명령어로 Python 3를 설치합니다.

brew install python

Step 3. PATH 설정 확인하기

이제 Python이 정상적으로 설치되었는지, 다음 명령어로 버전을 확인합니다.

python3 --version

기본적으로 Homebrew를 통해 설치된 Python의 경로는 다음과 같습니다.

/opt/homebrew/bin/python3

위 경로를 PATH에 추가하려면, 다음 명령어를 터미널에서 실행하세요.

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Step 4. python 명령어를 python3로 연결하기 (옵션)

기본적으로 python3 명령어를 통해 실행하지만, 단순히 python 명령어를 사용하고 싶다면 심볼릭 링크를 추가합니다.

ln -s $(which python3) /opt/homebrew/bin/python

이제 다음과 같이 정상적으로 동작하는지 확인합니다.

python --version

이제 정상적으로 Python 명령어를 사용할 수 있습니다.

---

🚨 그래도 해결되지 않는다면?

• 터미널을 재시작하거나 시스템을 재부팅해보세요.
• 터미널 앱 자체의 권한 문제인지 확인해보세요.

이 글이 도움이 되었길 바랍니다. 😉