Pyenv 파이썬 가상화

pyenv 사용법

pyenv는 여러 Python 버전을 설치하고 프로젝트별로 전환해 주는 도구입니다.

설치

- macOS (Homebrew)**

brew update
brew install pyenv

- Linux**

curl https://pyenv.run | bash

- Windows**: 별도 프로젝트인 pyenv-win을 사용합니다.

```powershell
choco install pyenv-win
# 또는
pip install pyenv-win --target $HOME\.pyenv

셸 설정

`~/.zshrc` 또는 `~/.bashrc`에 추가합니다.

export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - zsh)"   # bash라면 "bash"

적용:

exec "$SHELL"

빌드 의존성 설치 (Linux 필수)

pyenv는 소스에서 Python을 컴파일하기 때문에 필요한 패키지가 있어야 합니다.

- Ubuntu/Debian**

sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl git libncursesw5-dev \
xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

macOS는 `xcode-select --install`로 충분한 경우가 많습니다.

기본 명령어

pyenv install --list        # 설치 가능한 버전 목록
pyenv install 3.12.4        # 특정 버전 설치
pyenv versions              # 설치된 버전 목록
pyenv version               # 현재 사용 중인 버전
pyenv uninstall 3.12.4      # 삭제

버전 목록 필터링:

pyenv install --list | grep " 3\.12"

1. 5. 버전 지정 방법

파이썬 버전 지정하는 방법
전역	`pyenv global 3.12.4`	기본 Python 버전
디렉터리	`pyenv local 3.11.9`	현재 폴더에 `.python-version` 파일 생성
세션	`pyenv shell 3.10.14`	현재 터미널 세션에서만 적용

우선순위는 `shell` > `local` > `global`입니다.

확인:

python --version
pyenv which python

가상환경 (pyenv-virtualenv)

설치


# Homebrew
brew install pyenv-virtualenv

# Linux (pyenv.run으로 설치했다면 이미 포함됨)
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv

셸 설정에 추가:


eval "$(pyenv virtualenv-init -)"

사용

pyenv virtualenv 3.12.4 myenv    # 생성
pyenv activate myenv             # 활성화
pyenv deactivate                 # 비활성화
pyenv local myenv                # 폴더 진입 시 자동 활성화
pyenv virtualenv-delete myenv    # 삭제

가상환경이 필요한 것뿐이라면 pyenv로 버전을 고르고 표준 `venv`를 써도 됩니다.

pyenv local 3.12.4
python -m venv .venv
source .venv/bin/activate

= 업데이트


brew upgrade pyenv     # Homebrew
pyenv update           # pyenv.run으로 설치한 경우

새 Python 버전이 목록에 안 보이면 pyenv 자체를 업데이트해야 합니다.

자주 발생하는 문제

- **`pyenv: command not found`**: 셸 설정 파일에 PATH/init 설정이 빠졌거나 셸을 재시작하지 않은 경우입니다.

- **설치 중 `BUILD FAILED`**: 빌드 의존성이 부족한 경우가 대부분입니다. 3번 항목을 다시 확인하세요.

- **버전을 바꿨는데 적용이 안 됨**: `pyenv versions`로 `*` 표시를 확인하고, `which python`이 `~/.pyenv/shims/python`을 가리키는지 확인하세요.

- **새로 설치한 패키지 명령어가 인식 안 됨**: `pyenv rehash`를 실행하세요.

간단한 워크플로 예시

pyenv install 3.12.4
mkdir myproject && cd myproject
pyenv local 3.12.4
python -m venv .venv
source .venv/bin/activate
pip install requests

Comments