[Python]macOS에서 Python 최신 LTS 버전으로 설치와 `python` 명령어로 사용 (업데이트 버전)

📌 macOS에서 Python을 최신 LTS 버전으로 설치하고 python 명령어로 사용하는 가장 일반적인 방법 정리

---

✅ 1. macOS 기본 Python은 어떤가요?

• macOS에는 기본적으로 /usr/bin/python3 경로에 Python 3이 설치되어 있음
• 이는 Xcode Command Line Tools를 설치하면 자동으로 포함되며, 시스템 보호로 인해 사용자가 업데이트/변경하기 어려움
• /usr/bin/python은 구버전 Python 2일 수 있으며 macOS 12 이상에서는 기본적으로 제거되기도 함

---

✅ 2. Homebrew로 Python 최신 LTS 설치 (가장 일반적인 방식)

🔹 설치 방법

brew install python

• 이 명령어는 항상 Python의 최신 안정 버전 (LTS) 를 설치함
• 예: 현재 기준 Python 3.12.x
• Homebrew는 LTS를 기본으로 제공하기 때문에 버전을 명시하지 않아도 최신 안정 버전이 설치됨

🔹 설치 확인

which python3
# → /opt/homebrew/bin/python3 (Apple Silicon) 또는 /usr/local/bin/python3 (Intel Mac)

python3 --version
# → Python 3.12.3 (예시)

---

✅ 3. python 명령어를 python3로 대체하기 (Homebrew 방식)

macOS에서는 여전히 python 명령어가 비어있거나 Python 2를 가리키는 경우가 많기 때문에, 아래처럼 심볼릭 링크를 지정하여 변경합니다.

🔹 방법: 심볼릭 링크 설정

# 백업 (이미 있다면)
sudo mv /usr/local/bin/python /usr/local/bin/python_backup 2>/dev/null

# python → python3 최신 버전으로 심볼릭 링크
ln -sfn $(which python3) /usr/local/bin/python

# 안되면 (ln: /usr/local/bin/python: Permission denied)
sudo ln -sfn $(which python3) /usr/local/bin/python

🔹 확인

which python
# → /usr/local/bin/python

python --version
# → Python 3.12.3

---

✅ 4. (대안) pyenv로 LTS 최신 버전 설치 및 python 자동 설정 (버전 관리가 필요할 경우)

🔹 pyenv 설치

brew install pyenv

🔹 최신 LTS 버전 자동 설치

latest=$(pyenv install --list | grep -E '^ 3\.[0-9]+\.[0-9]+$' | tail -n 1 | xargs)
pyenv install "$latest"
pyenv global "$latest"

🔹 셸 환경 설정 (zsh 기준)

echo 'eval "$(pyenv init --path)"' >> ~/.zprofile
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
source ~/.zprofile
source ~/.zshrc

🔹 python 명령어는 자동으로 연결됨

• pyenv는 내부적으로 ~/.pyenv/shims/python을 통해 python, python3, pip 등을 자동 연결
• 별도 ln -s 작업 없이도 python 명령어가 선택된 버전을 가리킴
• 단, 위 셸 초기화 설정(eval ...)이 꼭 되어 있어야 함

---

🟡 Homebrew vs pyenv 비교 요약

항목	Homebrew	pyenv
설치 목적	최신 LTS 설치	여러 버전 관리
설치 명령	brew install python	pyenv install 3.x.x
버전 명시 없이 설치	✅ 가능	❌ 직접 버전 지정 필요 (스크립트로 우회 가능)
python 명령 자동화	❌ 심볼릭 링크 필요	✅ 자동 shim 처리
추천 상황	일반 사용자, 단일 버전	프로젝트별 버전 분리 필요할 때

---

✅ 실무에서 가장 많이 사용하는 조합은?

# 일반 사용자 기준 추천 흐름
brew install python
ln -sfn $(which python3) /usr/local/bin/python

이후에는 python, python3, pip, pip3 모두 최신 Python 버전을 가리킵니다.

---

📌 추가 팁: .zshrc, .bash_profile에 아래 설정이 없으면 pyenv가 제대로 작동하지 않을 수 있습니다.

export PATH="$HOME/.pyenv/shims:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"

---

참고: pyenv 로 설치 전환

2025.10.17 - [Setting] - [Python] Apple Silicon Mac에서 Homebrew Python → pyenv 전환 완벽 가이드