개요
Python은 다양한 버전이 존재하고, 각 프로젝트마다 필요한 버전이 다를 수 있다. 이럴 때 pyenv를 사용하면 여러 개의 Python 버전을 쉽게 관리할 수 있다. pyenv는 특정 프로젝트에 맞는 Python 버전을 설정하고, 필요에 따라 쉽게 전환할 수 있도록 도와준다. 본 글에서는 Mac에서 pyenv를 설치하고 사용하는 방법에 대해 자세히 알아보자.
설치
pyenv를 설치하기 위해 Homebrew를 사용한다.
brew install pyenv
이제 pyenv가 정상적으로 설치되었는지 확인해보자. 다음 명령어를 입력하면 pyenv의 버전이 출력된다.
pyenv --version
설치가 완료되면, 다양한 Python 버전을 설치할 수 있다. 예를 들어, Python 3.12.9를 설치하고 싶다면 아래의 명령어를 입력한다.
pyenv install 3.12.9
설치가 완료되면, 설치된 Python 버전을 확인할 수 있다. 다음 명령어를 입력해보자.
pyenv versions
이 명령어를 입력하면 현재 설치된 Python 버전 목록이 출력된다.
구조
system에 이미 설치되어있는 python과 pyenv에 설치된 python들의 구조를 알아보자.
기본적으로 system에 설치된 python은 거의 대부분에 경로에서 사용된다. 만약 pyenv를 통해 명시한 python을 사용한다면, pyenv에서 사용하는 python의 사용 공간은 제한적이다. 그리고 설정된 python version이 pyenv의 local, global 여부에 따라 지원할 수 있는 범위가 다시 달라진다.
실행
이제 pyenv를 통해 설치한 Python 버전을 사용할 수 있다. 특정 프로젝트에서 사용할 Python 버전을 설정하려면, 해당 프로젝트 디렉토리로 이동한 후 아래의 명령어를 입력한다. 이렇게 하면 해당 디렉토리에서만 Python 3.12.9 버전을 사용할 수 있다.
pyenv local 3.12.9
만약 전역적으로 사용할 Python 버전을 설정하고 싶다면 아래의 명령어를 입력한다.
pyenv global 3.12.9
현재 pyenv가 바라보는 Python 버전을 확인하려면 다음 명령어를 입력한다.
pyenv versions
실습
# 현재 system의 python3 버전을 확인한다.
python3 --version
Python 3.12.9
# 현재 pyhon3의 경로를 확인한다.
which python3
/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
# pyenv로 3.13.1 버전의 python을 지정한다.
pyenv global 3.13.1
# 설정된 3.13.1 환경으로 pyenv 시작
eval "$(pyenv init -)"
# python3 경로를 재확인한다
which python3
/Users/ks.kwon/.pyenv/shims/python3
# python3 버전을 재확인한다 -> 3.13.1 환경으로 python 사용
python3 --version
Python 3.13.1
결론
pyenv를 사용하면 여러 개의 Python 버전을 쉽게 관리할 수 있다. 프로젝트마다 필요한 버전을 설정하고, 가상 환경을 통해 독립적인 개발 환경을 유지할 수 있다. pyenv를 통해 다양한 Python 프로젝트를 효율적으로 관리해보자.
참고문헌
GitHub: MacOS Python(pyenv) 설치 및 버전관리
티스토리: MacOS 에 pyenv 설치 및 사용 하는법
'Programming > python' 카테고리의 다른 글
| dotenv의 기본 개념과 사용법 (0) | 2025.04.23 |
|---|---|
| Poetry: Python 프로젝트 의존성 관리 도구 (0) | 2025.04.08 |