-
pyenv 설치 | Ubuntu 서버 세팅, 이 순서대로 하면 끝 (6)Dev 2025. 4. 5. 09:00반응형
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 기반 개발 환경의 절반 이상은 완성된 셈이다.
반응형'Dev' 카테고리의 다른 글
Poetry 설치 | Ubuntu 서버 세팅, 이 순서대로 하면 끝 (8) (0) 2025.04.07 autoenv 설치 | Ubuntu 서버 세팅, 이 순서대로 하면 끝 (7) (0) 2025.04.06 Glances 설치 (시스템 모니터링 툴) | Ubuntu 서버 세팅, 이 순서대로 하면 끝 (5) (0) 2025.04.04 Oh My Zsh 설치 & 기본 에디터 설정 (Vim) | Ubuntu 서버 세팅, 이 순서대로 하면 끝 (4) (0) 2025.04.03 방화벽 설정 (UFW) | Ubuntu 서버 세팅, 이 순서대로 하면 끝 (3) (0) 2025.04.03