Como usar ambientes virtuais em Python

Você pode substituir esse comportamento, mas somente ao criar um ambiente virtual pela primeira vez. Se você passar a bandeira --system-site-packages para venv quando você executá-lo, o venv criado terá acesso ao diretório do pacote pai do Python.

Usando ambientes virtuais Python com notebooks Jupyter

Se você estiver usando notebooks Jupyter (também conhecidos como notebooks IPython) e já tiver o Jupyter instalado em todo o sistema, crie seu ambiente virtual e ative-o. Então, no diretório do seu ambiente virtual, execute pip install ipykernel para adicionar os componentes necessários para IPython. Finalmente, corra ipython kernel install —user —name=onde project_name é um nome que você deseja associar a esse projeto específico. A partir daí, você poderá iniciar o Jupyter e mudar para o kernel IPython instalado dentro do ambiente virtual.

Atualizando ambientes virtuais Python

Quando você atualiza um runtime do Python em seu sistema, os ambientes virtuais que usam essa versão do Python não são atualizados automaticamente. Essa é sua responsabilidade. E isso ocorre intencionalmente, porque atualizações involuntárias para versões do Python podem quebrar seus pacotes correspondentes.

Se você atualizou um interpretador Python existente com um menor atualização pontual — por exemplo, do Python 3.13.1 para o Python 3.13.3 — você pode atualizar qualquer ambiente virtual correspondente com bastante facilidade. Em um prompt de comando no diretório do projeto, digite:

python -m venv /path/to/venv --upgrade

Não ative o ambiente virtual de antemão, ou a atualização pode não funcionar.

Como alternativa, conforme observado acima (consulte “Removendo o ambiente virtual Python”), você pode optar por remover completamente o venv e recriá-lo usando seu arquivo requirements.txt ou pyproject.toml.

Se você instalou um principal nova versão do Python — por exemplo, você já tem o Python 3.10 e agora instala o Python 3.11 junto com ele — você precisará criar um novo ambiente virtual que use especificamente a nova versão principal. Não tente atualizar um ambiente virtual existente para uma versão mais avançada do Python.