pyenv/pyenv-virtualenv

어떤 프로젝트인가요?

핵심 기능

• 01선택한 pyenv 설치 Python 버전으로 virtualenv를 만듭니다.
• 02기존 virtualenv와 conda 환경을 조회하고 삭제합니다.
• 03디렉터리의 .python-version 파일을 기준으로 환경을 자동 활성화합니다.
• 04conda, virtualenv 또는 내장 venv 모듈과 함께 사용할 수 있습니다.
• 05활성 환경을 표시하는 셸 프롬프트를 설정할 수 있습니다.

활용 사례

• macOS 또는 Linux에서 프로젝트별로 Python 환경을 분리해 관리합니다.
• 셸에서 디렉터리를 이동할 때 프로젝트 환경을 자동으로 전환합니다.
• pyenv로 설치한 Python 버전과 함께 conda 환경을 관리합니다.

빠른 시작

1. 1

   pyenv-virtualenv를 pyenv 플러그인 디렉터리에 체크아웃합니다

   git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
2. 2

   선택 사항으로, 자동 활성화를 위해 셸에 pyenv virtualenv-init을 추가합니다

   echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc
3. 3

   셸을 다시 시작해 pyenv-virtualenv를 활성화합니다

   exec "$SHELL"
4. 4

   pyenv에서 관리하는 Python 버전을 기반으로 virtualenv를 만듭니다

   pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

사용 전 알아둘 점

• !UNIX 계열 시스템만 지원합니다. pyenv 플러그인이므로 pyenv를 설치해야 합니다.
• !pyenv가 필요하므로 먼저 pyenv를 설정해야 합니다.

토픽

자주 묻는 질문

pyenv-virtualenv은(는) 무엇인가요?

UNIX 계열 시스템에서 Python virtualenv와 conda 환경을 만들고, 조회하고, 활성화하고, 삭제하는 pyenv 플러그인입니다. pyenv-virtualenv는 Python 버전 관리자인 pyenv에 가상 환경 관리 명령을 추가합니다. `pyenv virtualenv`로 설치된 특정 Python 버전을 기반으로 virtualenv를 만들고, `pyenv virtualenvs`로 기존 환경을 조회하며, `pyenv virtualenv-delete`로 삭제할 수 있습니다. 옵션은 conda, virtualenv 또는 표준 `python -m venv` 모듈 등 실제 작업을 수행하는 도구에 전달됩니다.

pyenv-virtualenv은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

pyenv-virtualenv은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

pyenv-virtualenv은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. pyenv-virtualenv의 마지막 커밋은 2026년 10월 12일입니다.

pyenv-virtualenv은(는) 어디에 사용할 수 있나요?

macOS 또는 Linux에서 프로젝트별로 Python 환경을 분리해 관리합니다. 셸에서 디렉터리를 이동할 때 프로젝트 환경을 자동으로 전환합니다. pyenv로 설치한 Python 버전과 함께 conda 환경을 관리합니다.

pyenv-virtualenv는 어떻게 설치하나요?

pyenv-virtualenv를 pyenv 플러그인 디렉터리에 체크아웃합니다: git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv 선택 사항으로, 자동 활성화를 위해 셸에 pyenv virtualenv-init을 추가합니다: echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc 셸을 다시 시작해 pyenv-virtualenv를 활성화합니다: exec "$SHELL" pyenv에서 관리하는 Python 버전을 기반으로 virtualenv를 만듭니다: pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

pyenv-virtualenv은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pyenv/pyenv-virtualenv