본문 바로가기
프로그래밍언어/Python

Python : 관리 도구 pyenv 가이드

by plog 2025. 5. 5.

Python: pyenv

여러 프로젝트에서 다른 버전의 Python을 사용해야 할 때 좋습니다. 프로젝트 종속적인 가상환경이 필요 할 때 좋습니다. 이럴 때 필요한게  바로 pyenv입니다.

 

pyenv란

pyenv는 다양한 Python 버전을 설치하고 손쉽게 전환할 수 있게 해주는 Python 버전 관리 도구입니다. anaconda, pipenv와 비슷한 용도 입니다.

 

pyenv 설치 방법

1. 설치

Homebrew를 통해 설치하면 편리합니다.

Homebrew를 잘 모르시는분은 파이썬 설치할 때 설명드린 Homebrew 설명서 참고 해주세요 (Homebrew 설치 및 가이드

brew update
brew install pyenv

 

2. 환경설정

.bashrc, .zshrc 또는 .bash_profile에 아래 줄 추가 합니다. 저는 .zshrc 파일에 추가 했습니다. 
터미널에서 vi ~/.zshrc

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

 

3. 변경사항 적용
터미널 재시작 or source ~/.zshrc

4. pyenv-virtualenv
pyenv는 가상환경 관리까지 확장할 수 있습니다. pyenv-virtualenv 플러그인을 설치하면 프로젝트별로 독립된 환경을 쉽게 구성할 수 있습니다.

brew install pyenv-virtualenv

.zshrc에 추가 설정

eval "$(pyenv virtualenv-init -)"

 

5. 가상환경 테스트

pyenv virtualenv 3.10.4 myenv
pyenv activate myenv

 

pyenv 필수 명령어

1) pyenv install <버전>

지정한 Python 버전을 설치합니다. 예: pyenv install 3.11.2

 

2) pyenv uninstall <버전>

설치된 Python 버전을 제거합니다.

 

3) pyenv versions

설치된 Python 버전 목록과 현재 활성화된 버전을 확인합니다.

 

4) pyenv global <버전>

시스템 전체(Global)에서 사용할 Python 버전을 설정합니다.

 

5) pyenv local <버전>

현재 디렉토리(프로젝트)에서 사용할 Python 버전을 설정합니다.

 

6) pyenv shell <버전>

현재 쉘 세션에서만 일시적으로 Python 버전을 설정합니다.

 

7) pyenv version

현재 사용 중인 Python 버전을 표시합니다.

 

8) pyenv install --list

설치 가능한 모든 Python 버전 목록을 보여줍니다.

 

9) pyenv which python

설치 가능한 모든 Python 버전 목록을 보여줍니다.

 

pyenv-virtualenv 필수 명령어

1) pyenv virtualenv <버전> <이름>

해당 버전의 Python으로 가상환경을 생성합니다. 예) pyenv virtualenv 3.10.4 myenv

 

2) pyenv activate <이름>

지정한 가상환경을 활성화합니다.

 

3) pyenv deactivate

현재 활성화된 가상환경을 비활성화합니다.

 

4) pyenv virtualenvs

생성된 가상환경 목록을 확인합니다.

 

같이 볼만한 정보 

맥에 그림판 사용하는 방법

맥에 필수 무료 압축 프로그램:keka

맥 필수 단축키 총정리

 

#Python, #pyenv, #개발환경, #Python버전관리, #가상환경, #파이썬기초, #맥북

 

댓글