pyenv 설치 및 설정하기

2020년 7월 3일 수정

pyenv의 설치 및 설정법은 약간 귀찮아서 이 글에 별도로 정리한다.

설치

macOS 에서는 Homebrew 로 설치하는 것이 편하다. 터미널에서 아래 커맨드로 설치할 수 있다.

brew install pyenv

일단 기본 설치는 끝이다.

설치 후속 조치

개인적인 경우의 문제였는 지는 잘 모르겠지만, 최근 버전에서는 버전 리스트 관리 방식이 바뀌었는지 목록이 업데이트 되지 않는 경우를 겪었다. 이 문제를 대비하기 위해 미리 아래 커맨드를 입력해서 후속 설치를 하는 것이 좋을 것 같다.

git clone https://github.com/pyenv/pyenv.git ~/.pyenv

이미 기존이 ~/.pyenv 디렉토리가 있을 경우 설치가 안 될 수도 있으니 미리 삭제하고 진행하자.

일단 이 과정은 필수는 아니다. 아마도 하지 않아도 당장의 동작에는 문제는 없을 것이다.

셸 환경 설정

이제 환경변수를 몇 가지 설정해야 한다. 공식 사이트에서는 아래 커맨드를 이용하라고 한다.

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile
echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.bash_profile

물론 사용하는 에 따라서 대상 파일 이름이 달라진다는 점에 주의하자.

셸 환경 설정 (수동)

bash를 사용한다면 위의 설정을 해도 별 문제는 없겠지만, 개인적으로는 zsh을 쓰기 때문에 별도로 수동으로 설정을 했다. 혹시 다른 을 사용한다면 별도로 설정을 해 주자.

앞서 말했다시피 개인적으로는 zsh을 쓰기 때문에 ~/.zshrc 파일에 직접 아래와 같은 내용을 넣었다.

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

마지막 한 줄은 pyenv에서 virtualenv를 같이 쓰려는 경우에만 필요하다. 따라서 pyenv로 virtualenv 환경 관리하기를 하려면 꼭 추가해주자.

이후 을 새로 기동하자. 혹은 터미널을 껐다 켜도 되고 source 등의 커맨드로 다시 스크립트를 로딩 해도 관계는 없다.