pyenv와 pyenv-virtualenv로 파이썬 버전 및 가상환경 관리하기

pyenv로 파이썬 설치

WSL 환경에서 pyenv를 이용하면 다양한 파이썬 버전을 손쉽게 설치할 수 있습니다.
먼저 설치 가능한 버전을 확인합니다.

pyenv install --list

원하는 버전을 골라 설치합니다. 예를 들어:

pyenv install 3.7.13
pyenv install 3.8.13

설치 후 확인:

pyenv versions

 

pyenv-virtualenv로 가상환경 생성

pyenv-virtualenv를 활용하면 특정 파이썬 버전에 기반한 가상환경을 만들 수 있습니다.

pyenv virtualenv 3.7.13 django-envs

 

• 3.7.13 → 기반이 되는 파이썬 버전
• my-env → 생성할 가상환경 이름

pyenv로 가상환경을 만들면 3.7.13/envs/django-envs와 django-envs 두 가지가 표시됩니다

• 3.7.13/envs/django-envs → 해당 가상환경이 어떤 파이썬 버전을 기반으로 만들어졌는지를 보여주는 실제 경로
• django-envs → 이 경로를 가리키는 심볼릭 링크(바로가기)

즉, 두 이름은 같은 가상환경을 의미하며, 어느 쪽을 사용해도 결과는 동일합니다.
쉽게 말해, django-envs는 3.7.13/envs/django-envs를 가리키는 “바로 가기”라고 생각하면 됩니다.

 

삭제 시:

pyenv uninstall my-env

 

환경 적용 (global vs local)

global: 시스템 전역에서 기본으로 사용할 환경

pyenv global 3.8.13

 

local: 특정 디렉토리에서만 사용할 환경

cd my-project
pyenv local my-env

 

• global로 지정한 환경은 전체 시스템에 적용
• local로 지정한 환경은 해당 디렉토리 및 하위 디렉토리에서만 적용

 

정리

• pyenv: 여러 파이썬 버전을 설치하고 전환
• pyenv-virtualenv: 가상환경 생성 및 관리
• global / local 설정: 환경을 전역 또는 특정 프로젝트 단위로 적용

한 번 설정해두면 디렉토리에 들어갈 때마다 자동으로 해당 가상환경이 적용되어, 개발 환경을 깔끔하게 관리할 수 있습니다.