Pacotes separados para cada projeto
Um ambiente virtual é um diretório com um interpretador Python e um conjunto próprio de pacotes instalados. Ele permite manter as dependências de um projeto separadas das usadas por outros projetos, inclusive quando cada um exige uma versão diferente da mesma biblioteca.
O módulo venv cria o ambiente a partir de uma instalação Python existente. O executável no novo diretório pode ser uma cópia ou um link para o interpretador de origem. Por padrão, os pacotes dessa instalação de origem ficam fora do ambiente, embora a opção --system-site-packages permita acesso a eles.
Qual interpretador está em uso
Neste exemplo para Linux ou macOS, com Python 3 instalado, o primeiro comando cria o diretório .venv. O segundo consulta o caminho do interpretador usado pelo próprio ambiente.
python3 -m venv .venv.venv/bin/python -c "import sys; print(sys.executable)"A saída deve apontar para o executável dentro de .venv/bin, com o caminho correspondente à sua pasta. No Windows, os executáveis ficam em Scripts. Essa consulta verifica a seleção do interpretador sem exigir a ativação do ambiente no shell.
Limites do isolamento
O ambiente separa os pacotes Python, mas continua utilizando as permissões do processo no sistema operacional. Ele não restringe por si só o acesso aos arquivos do computador. Para reproduzir o projeto em outro local, recrie o ambiente e instale as dependências registradas, conforme orienta a documentação do venv.
Dúvidas frequentes
Perguntas frequentes sobre ambiente virtual
- Um ambiente virtual cria outro sistema operacional?
- O ambiente mantém executáveis e pacotes Python em um diretório próprio. Ele utiliza o sistema operacional existente e não oferece o isolamento de uma máquina virtual.
- É obrigatório ativar o ambiente?
- Você pode executar o interpretador pelo caminho completo. A ativação acrescenta o diretório dos executáveis do ambiente ao início do PATH, facilitando o uso dos comandos no shell.
- Posso copiar a pasta do ambiente para outro computador?
- A documentação recomenda recriar o ambiente no destino. Os scripts instalados podem guardar caminhos absolutos, por isso uma cópia da pasta pode deixar de funcionar.
Para continuar
Recursos relacionados
Documentação
Python: criação e uso de ambientes virtuais
Mostra como criar um ambiente com venv, selecionar seu interpretador e recriá-lo em outro diretório.
Abrir recursoAplicação na formação
Developer Workspace
A seleção do interpretador Python define onde as dependências do projeto são instaladas e quais bibliotecas ficam disponíveis.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.