pyenv, venv 정리

파이썬을 설치하면서 알게 된 내용이 있습니다.

 

바로 pyenv, venv이다. 이 둘을 용도는 알지만 명확하지 못해서 정리하고 합니다.

 

---

1. pyenv

목적: 다양한 Python 인터프리터 버전을 설치•관리하고, 전역(global)•프로젝트(local)•쉘(shell) 단위로 버전을 전환할 수 있는 버전 관리 도구입니다.

 

설치: brew로 설치를 진행했습니다.

brew install pyenv

 

주요기능:

• pyenv install <version>으로 원하는 Python 버전 설치
• pyenv global/local/shell <version> 으로 활성 버전 전환
• 플러그인 (예: pyenv-virtualenv)을 통해 가상환경 통합 관리도 가능

예시:

global

# 1) 글로벌(default) 버전 설정
# 시스템 전체(로그인 세션)에서 기본으로 사용할 Python 버전을 3.10.6으로 지정
$ pyenv global 3.10.6
$ python -V
Python 3.10.6

 

local

# 2) 로컬(project) 버전 설정
# 현재 디렉터리(my-project) 및 그 하위에서만 Python 3.8.0을 사용
$ cd my-project
$ pyenv local 3.8.0
# 이 명령 실행 시 my-project/.python-version 파일이 생성됩니다.
$ python -V
Python 3.8.0

 

shell

# 3) 쉘(session) 전용 버전 설정
# 현재 터미널 세션에서만 잠시 Python 3.9.1을 사용하고, 세션 종료나 재로그인 시 해제
$ pyenv shell 3.9.1
$ python -V
Python 3.9.1

# 원래 버전으로 복귀하려면
$ pyenv shell --unset
$ python -V
# (글로벌 또는 로컬에 지정된 버전으로 돌아갑니다)

 

 

2. venv

목적: Python 3.3이상 표준 라이브러리에 포함된 가상환경 생성 도구로, 특정 python 인터프리터 기반의 독립된 패키지 격리를 제공합니다.

 

설치: 별도 설치 불필요(python3 -m venv <env> 명령 사용)

 

주요 기능:

• python -m venv ~/myenv (~/myenv 로 하면 home 하위에 생성 됨 원하는 경로로 해주면 됨)
• 실행
  • source ~/myenv/bin/activate
• 종료
  • deactivate

 

3. pyenv vs venv 비교

구분	pyenv	venv
역할	python 버전 관리	python 패키지 격리•가상환경 생성
범위	전역/프로젝트/쉘 단위 인터프리터 전환	단일 프로젝트 내에서 패키지 독립
설치	Github -> 쉘 설정 파일에 초기화 스크립트 추가	python 3.3+ 기본 내장 (-m venv)
활용 예	pyenv install 3.10.6 -> pyenv local 3.10.6	python -m venv .venf -> source .venv/bin/activate
확장성	플러그인 통해 virtualenv 등과 연동 가능	최소 기능, 복잡한 옵션은 virtualenv 권장

 

 

4. 추가 내용 (virtualenv)

Virtualenv:

 virtualenv는 python 프로젝트마다 독립적 실행 환경을 만들어 주는 서드파티 도구 입니다. 시스템 전체에 설치된 Python과는 별도로, 특정 버전의 Python 인터프리터와 pip•setyptolls•wheel 같은 필수 패키지를 격리된 디렉터리에 설치해줍니다. 어떻게 보면 venv와 비슷할 수 있지만 venv보다 더 복잡한 옵션을 활용할 수 있습니다.

 

특징:

• 전역(Global) 설치를 피하고, 프로젝트별로 서로 다른 라이브러리 버전을 공존시킬 수 있습니다.
• Python 2.x/3.x 모두에서 사용할 수 있습니다.