Pyenv로 파이썬 버전 관리하기

각종 실습을 하다 보면 특정 파이썬 버전이 필요한 경우가 많다. 이럴 때는 pyenv를 사용해 여러 버전의 파이썬을 설치하고 가상 환경을 구성하면 원활하게 학습할 수 있다.

1 1. pyenv 설치

맥북에서는 아래와 같이 pyenv 를 설치할 수 있다. 다른 플랫폼을 사용하고 있다면 공식 홈페이지 설치 안내 페이지를 참고하자.

brew update && brew install pyenv

설치를 완료했으면 아래 두 가지 명령어를 통해 설치 가능한 버전을 확인한 후, 해당 버전을 설치하면 된다.

pyenv install -list
pyenv install {version}

예를 들어, 이 글을 작성하는 시점의 stable version 은 3.13.0 이므로 이를 설치하려면 pyenv install 3.13.0 이라고 입력하면 된다.

특정 파이썬 버전까지 설치를 했다면 아래와 같은 명령어를 통해 설치한 버전을 확인하고 해당 버전을 기본값으로 설정하자.

pyenv versions
pyenv global {version}

예를 들어, pyenv global 3.13.0 이라고 하면 시스템 전체에 기본 파이썬 버전이 3.13.0 으로 설정된다.

보통 파이썬 개발 시 가상 환경을 설정하므로 이런 추가 설정이 필요 없을 수도 있다. 그러나 pyenv는 디렉토리별로 다른 파이썬 버전을 사용할 수 있도록 설정할 수 있어, 특정 요구가 있을 경우 유용하게 활용할 수 있다.

* 참고로 이 기능을 사용하려면 pyenv init 명령어를 통해 본인이 사용하는 Shell 에 환경변수를 추가해야 한다.

pyenv local {version}

특정 디렉토리에서 저 명령어를 실행하면 해당 디렉토리에 숨김 파일로 .python-version 파일이 생긴다. python -V 를 입력하면 해당 폴더에서는 당신이 지정한 특정 버전의 파이썬이 실행됨을 알 수 있다.