다른 명령
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"
버전 지정 방법
| 전역 | `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