오랜만에 잠들고 있는 맥북을 초기화 하고 다시 Pyenv를 깔았는데 pyenv global 설정을 해줬지만 바로 Python으로 사용을 못 했다.
그러다 이전에 찾았던 기억이 나서 다시 찾아 아래와 같이 공유 드립니다.
저는 2번 정도에서 성공 했습니다.
1. pyenv global로 기본 Python 설정
pyenv로 설치한 Python 3.11.11을 기본 Python으로 설정합니다:
pyenv global 3.11.11설정 후, 다시 Python 버전을 확인하세요:
python3 --version여전히 3.9.6이 나온다면 다음 단계를 진행합니다.
2. 쉘 초기화 파일 확인
pyenv의 경로 설정이 쉘 초기화 파일에 올바르게 적용되지 않았을 수 있습니다. 사용하는 쉘에 따라 초기화 파일을 수정하세요:
zsh 사용자 (macOS 기본 쉘)
~/.zshrc를 열고 다음 내용을 추가하거나 수정합니다:
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/shims:$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
bash 사용자
~/.bashrc를 열어 위와 동일한 내용을 추가합니다.
쉘 초기화 파일을 저장한 후, 쉘을 다시 로드합니다:
source ~/.zshrc # zsh 사용자
source ~/.bashrc # bash 사용자
3. PATH 확인
현재 pyenv의 shims 디렉토리가 PATH에 포함되어 있는지 확인합니다:
echo $PATH출력에 ~/.pyenv/shims가 포함되어 있지 않다면, 초기화 파일 설정이 제대로 적용되지 않은 것입니다. 위 단계를 다시 확인하세요.
4. Python 심볼릭 링크 확인
macOS에서는 기본적으로 /usr/bin/python3이 시스템 Python으로 연결되어 있습니다. 이를 우선적으로 pyenv의 Python으로 변경하려면:
ln -sf $(pyenv which python3) ~/.pyenv/shims/python3
ln -sf $(pyenv which python) ~/.pyenv/shims/python
5. Python 확인
설정을 마친 후 다시 Python 버전을 확인합니다:
python --version
python3 --version둘 다 3.11.11로 출력되어야 정상입니다.
6. 문제가 계속될 경우
- Homebrew Python과 충돌: Homebrew로 설치된 Python이 PATH에서 우선순위를 차지하고 있을 수 있습니다. 이를 비활성화하려면:
brew unlink python
- 점검 도구 실행: pyenv-doctor로 문제를 확인합니다.
brew install pyenv-doctor
pyenv doctor