pyenv/pyenv-virtualenv

O que é?

Recursos principais

• 01Cria virtualenvs a partir de uma versão escolhida do Python instalada pelo pyenv.
• 02Lista e exclui virtualenvs e ambientes conda existentes.
• 03Ativa ambientes automaticamente com base no arquivo .python-version de um diretório.
• 04Funciona com conda, virtualenv ou o módulo venv integrado.
• 05Permite personalizar o prompt do shell que indica o ambiente ativo.

Casos de uso

• Manter ambientes Python separados por projeto em uma máquina macOS ou Linux.
• Alternar automaticamente entre ambientes de projeto ao mudar de diretório no shell.
• Gerenciar ambientes conda junto com versões do Python instaladas pelo pyenv.

Início rápido

1. 1

   Faça o checkout de pyenv-virtualenv no diretório de plugins do pyenv

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

   Opcionalmente, adicione pyenv virtualenv-init ao seu shell para ativar os ambientes automaticamente

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

   Reinicie seu shell para habilitar o pyenv-virtualenv

   exec "$SHELL"
4. 4

   Crie um virtualenv com base em uma versão do Python gerenciada pelo pyenv

   pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

Antes de usar

• !Compatível apenas com sistemas do tipo UNIX; é um plugin do pyenv e requer que o pyenv esteja instalado.
• !Requer o pyenv, então você precisa configurá-lo primeiro.

Tópicos

Perguntas frequentes

O que é pyenv-virtualenv?

Plugin do pyenv para criar, listar, ativar e excluir ambientes virtualenv e conda em sistemas do tipo UNIX. pyenv-virtualenv estende o pyenv, o gerenciador de versões do Python, com comandos para gerenciar ambientes virtuais. Você pode criar um virtualenv baseado em uma versão específica do Python instalada com `pyenv virtualenv`, listar os ambientes existentes com `pyenv virtualenvs` e removê-los com `pyenv virtualenv-delete`. As opções são repassadas à ferramenta subjacente, que pode ser conda, virtualenv ou o módulo padrão `python -m venv`.

pyenv-virtualenv é gratuito? Qual é a licença?

pyenv-virtualenv é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

pyenv-virtualenv ainda é mantido?

Manutenção ativa. O último commit de pyenv-virtualenv foi em 12 de out. de 2026.

Para que posso usar pyenv-virtualenv?

Manter ambientes Python separados por projeto em uma máquina macOS ou Linux. Alternar automaticamente entre ambientes de projeto ao mudar de diretório no shell. Gerenciar ambientes conda junto com versões do Python instaladas pelo pyenv.

Como instalar pyenv-virtualenv?

Faça o checkout de pyenv-virtualenv no diretório de plugins do pyenv: git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv Opcionalmente, adicione pyenv virtualenv-init ao seu shell para ativar os ambientes automaticamente: echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc Reinicie seu shell para habilitar o pyenv-virtualenv: exec "$SHELL" Crie um virtualenv com base em uma versão do Python gerenciada pelo pyenv: pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

Onde consigo pyenv-virtualenv?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pyenv/pyenv-virtualenv