pyenv란 무엇이며 왜 필요한가요?

pyenv는 시스템에서 여러 Python 버전을 관리할 수 있는 간단하면서도 강력한 도구입니다. Python 개발자는 다양한 Python 버전이 필요한 여러 프로젝트를 작업해야 하는 경우가 많습니다. 이러한 버전을 수동으로 관리하는 것은 번거롭고 오류가 발생하기 쉽습니다. 여기서 pyenv가 등장하여 Python 버전 간을 쉽게 전환하여 프로젝트가 항상 올바른 버전에서 실행되도록 보장합니다.

왜 pyenv를 사용하나요?

• 버전 관리: 다양한 Python 버전을 쉽게 설치하고 전환할 수 있습니다.

• 프로젝트 격리: 호환성 문제를 방지하면서 각 프로젝트가 올바른 Python 버전을 사용하는지 확인하세요.

• 유연성: 여러 Python 버전에서 코드를 쉽게 테스트할 수 있습니다.

버전 충돌 문제에 직면했거나 동일한 시스템에서 Python 2.x와 3.x를 모두 사용해야 했던 경우 pyenv가 개발 작업 흐름을 어떻게 단순화하는지 높이 평가할 것입니다.

pyenv와 시 통합

pyenv는 종속성 및 Python 환경을 관리하는 도구인 Poetry와 매우 잘 작동합니다. 이미 Poetry에 익숙하다면(그렇지 않다면 Poetry 시작에 대한 내 기사를 확인하세요) 이를 pyenv와 결합하면 프로젝트를 더욱 효과적으로 제어할 수 있다는 것을 알게 될 것입니다.

Poetry를 사용하여 새 프로젝트를 생성하면 pyenv가 디렉터리에 설정한 Python 버전이 자동으로 사용됩니다. 이렇게 하면 프로젝트 요구 사항과 일치하는 환경에서 프로젝트 종속성을 관리할 수 있습니다.

pyenv 설치

pyenv 설치부터 시작하겠습니다. 설치 과정은 운영 체제에 따라 다릅니다.

macOS에서

Homebrew 사용:

brew update
brew install pyenv

실수로 Pyenv 제공 Python에 연결되는 것을 방지하려면 대화형 셸 구성에 다음 줄을 추가하세요.

• Bash/Zsh:

alias brew='env PATH="${PATH//$(pyenv root)\/shims:/}" brew'

• 물고기:

alias brew="env PATH=(string replace (pyenv root)/shims '' \"\$PATH\") brew"

리눅스에서

• 컬 사용:

curl https://pyenv.run | bash

설치 후 셸 구성 파일(예: .bashrc, .zshrc)에 다음을 추가하세요.

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

• 패키지 관리자 사용 Arch Linux에서는 pacman의 도움으로 설치할 수 있습니다.

sudo pacman -S pyenv

터미널에서 다음을 실행하여 ~/.bashrc에 명령을 추가합니다.

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

Zsh의 경우:

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

물고기의 경우:
Fish 3.2.0 이상이 있는 경우 대화형으로 다음을 실행하세요:

set -Ux PYENV_ROOT $HOME/.pyenv
fish_add_path $PYENV_ROOT/bin

그렇지 않으면 아래 스니펫을 실행하세요.

set -Ux PYENV_ROOT $HOME/.pyenv
set -U fish_user_paths $PYENV_ROOT/bin $fish_user_paths

이제 이것을 ~/.config/fish/config.fish:
에 추가하세요.

pyenv init - | source

자세한 내용은 GitHub를 확인하세요.

Pyenv 사용

1) Python 버전 확인

현재 사용 중인 Python 버전을 확인하려면:

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)

2) Python 버전 설치

pyenv를 사용하면 모든 버전의 Python을 쉽게 설치할 수 있습니다.

❯ pyenv install 3.11.9

파이썬 버전을 설치한 후 프로젝트에 대해 전역적으로 또는 로컬로 설정할 수 있습니다.

3) 글로벌 Python 버전 설정

권장되지 않음, 시스템에 문제가 발생할 수 있음
시스템 전체에서 기본적으로 사용될 전역 Python 버전을 설정할 수 있습니다.

pyenv global 3.10.6 

4) 로컬 Python 버전 설정

특정 프로젝트 디렉터리에 대한 로컬 Python 버전을 설정할 수도 있습니다. 이 버전은 해당 디렉토리에 있을 때 글로벌 버전을 재정의합니다:

❯ pyenv local 3.8.10

❯ pyenv versions
  system
* 3.11.9 (set by /home/shanu/test_folder/.python-version)

❯ python -V
Python 3.11.9 (my global version is 3.12.5)

설정을 해제하려면 다음을 실행하세요.

❯ pyenv local --unset

❯ pyenv versions
* system (set by /home/shanu/.pyenv/version)
  3.11.9

❯ python -V
Python 3.12.5

5) Python 버전 제거

더 이상 필요하지 않은 Python 버전을 제거하려면:

pyenv uninstall 3.11.9

결론

Pyenv는 특히 Poetry와 함께 사용할 때 Python 개발자에게 귀중한 도구입니다. Python 버전을 손쉽게 관리함으로써 버전 충돌을 걱정하는 대신 코드 작성에 집중할 수 있습니다. 다음 Python 프로젝트에서 시도해 보세요!