Como criar e usar ambientes virtuais (venv) no Python?

O que é um Ambiente Virtual?

Os ambientes virtuais é uma forma de simular um ambiente isolado, onde podemos gerenciar as dependências sem influenciar ou entrar em conflito com outros projetos.

Em Python chamamos de virtualenv ou venv.

Como criar uma venv

Na raiz do seu novo projeto, execute esse comando no terminal:

python -m venv .venv

Após executar este comando, será criado uma pasta .venv na raiz do seu projeto.
Lembre-se de adicionar a pasta no .gitignore caso envie seu projeto para um repositório Git.

Conectar no venv

Windows

.\.venv\Scripts\activate.bat

Linux/Mac

source .venv/bin/activate

Assim que executar esse comando, aparecerá uma informação no seu terminal indicando que você está conectado. Veja o (.venv) no inicio da linha do terminal.

Como usar a VENV?

Após entrar na venv, você pode instalar suas dependencias do projeto (modulos, libs em geral) e ter um controle mais preciso de quais dependencias este projeto especifico possui.

Quando você cria uma venv ela vem sem nenhuma lib.

Recomendo você sempre adicionar em um arquivo requirements.txt.

Como sair/desativar a VENV?

Para sair da venv, basta executar o comando ou fechar o terminal.

deactivate