pyenv 설치 | Ubuntu 서버 세팅, 이 순서대로 하면 끝 (6)
pyenv 설치 – 원하는 Python 버전을 자유롭게 관리하기
서버 환경에서 여러 프로젝트를 관리하다 보면, 각기 다른 Python 버전을 요구하는 상황이 종종 생긴다.
이럴 때 버전을 손쉽게 설치하고 전환할 수 있도록 도와주는 도구가 바로 pyenv다.
이번 글에서는 pyenv 설치에 필요한 준비부터, 원하는 Python 버전을 설치하고 적용하는 방법까지 차례대로 정리해본다.
1. pyenv 설치에 필요한 필수 패키지 준비
먼저 Python을 컴파일하는 데 필요한 개발 패키지들을 설치하자. 다음 명령어를 복사해서 실행하면 된다:
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev \
wget curl llvm libncurses5-dev \
libncursesw5-dev xz-utils tk-dev \
libffi-dev liblzma-dev python3-openssl \
git
이 패키지들은 pyenv로 Python을 소스에서 직접 빌드할 때 꼭 필요한 의존성들이다.
설치하지 않으면 pyenv install 명령이 실패할 수 있으니, 미리 한 번에 설치해두자.
2. pyenv 설치
이제 본격적으로 pyenv를 설치하자. 아래 명령어 하나로 설치가 가능하다:
curl -fsSL https://pyenv.run | bash
설치가 완료되면 ~/.pyenv 경로에 pyenv 관련 디렉토리가 생성된다.
🔗 pyenv 공식 설치 문서
3. zsh 환경에서 pyenv 설정
Zsh 셸을 사용 중이라면 .zshrc에 아래 설정을 추가해야 pyenv가 정상 작동한다:
echo '# pyenv' >> ~/.zshrc
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
source ~/.zshrc
이 설정을 적용하면 터미널을 새로 열 때마다 pyenv 명령을 사용할 수 있다.
4. Python 버전 설치 및 적용
설정이 완료되었다면 원하는 Python 버전을 설치해보자.
예를 들어 Python 3.12.6을 설치하려면 다음과 같이 입력한다:
pyenv install 3.12.6
설치가 끝나면 해당 버전을 특정 디렉토리에서 사용하도록 설정할 수 있다:
pyenv local 3.12.6
적용된 버전은 다음 명령어로 확인할 수 있다:
pyenv versions
여기서 현재 선택된 버전 앞에는 * 표시가 붙는다. (아래 사진 참고)
마무리
pyenv는 프로젝트마다 다른 Python 버전을 자유롭게 설정하고 관리할 수 있게 해주는 강력한 도구다.
특히 poetry와 함께 사용하면, 개발 환경을 훨씬 깔끔하고 일관성 있게 유지할 수 있다.
다음 글에서는 Python 패키지와 가상환경 관리를 도와주는 poetry 설치와 설정 방법을 이어서 다룰 예정이다.
여기까지 잘 따라왔다면, 이미 탄탄한 Python 기반 개발 환경의 절반 이상은 완성된 셈이다.