A ferramenta Python venv permite criar ambientes virtuais para isolar cada trabalho e evitar conflitos entre diferentes versões.
Com esse recurso, você pode trabalhar em vários projetos ao mesmo tempo, sem se preocupar com interferências entre diferentes bibliotecas instaladas no sistema. Além disso, fica mais fácil gerenciar pacotes de forma eficiente e trabalhar em equipe sem conflitos.
Por que usar ambientes virtuais em Python?
Ambientes virtuais são espaços exclusivos para cada projeto Python, em que todas as ferramentas e configurações funcionam em harmonia, sem interferir umas nas outras.
Nesses espaços, cada trabalho funciona de forma independente, com suas próprias bibliotecas e configurações específicas.
Conheça os benefícios reais dessa abordagem:
-
- Isolamento de dependências: cada projeto mantém as suas próprias bibliotecas. Assim, se um projeto precisa da versão 2.0 de uma biblioteca e outro necessita da versão 3.0, ambos podem coexistir sem conflitos;
- Facilidade na colaboração: quando uma equipe trabalha em conjunto, todos podem utilizar exatamente as mesmas versões das bibliotecas, o que torna a colaboração muito mais fluida;
- Organização do sistema: ao manter cada projeto com as suas próprias dependências, o sistema principal permanece limpo e organizado. É como ter um depósito em que cada cômodo guarda apenas o que realmente precisa, sem acumular itens desnecessários.
Pré-requisitos
Antes de começar a desenvolver com Python, é preciso verificar se a linguagem foi instalada no seu sistema, seja ele uma máquina local ou um VPS (Servidor Virtual Privado).
Para quem usa Linux, o comando
python venv linux
pode ser utilizado para facilitar a criação e a ativação do ambiente virtual diretamente no terminal.
Caso utilize o Visual Studio Code, você também pode usar o suporte direto para ambientes virtuais, o que facilita a configuração com comandos como
python venv vscode.
Já para verificar a versão do Python (python venv version), abra o terminal (no Linux ou macOS) ou o prompt de comando (no Windows) e digite:
python --version.
A seguir, saiba mais sobre como verificar esses pré-requisitos.
Verificar a instalação do Python
Para verificar se o Python está instalado no seu sistema, basta abrir o terminal (no Linux ou macOS) ou o prompt de comando (no Windows) e digitar o seguinte código:
$ python --version.
Ou, em algumas distribuições e configurações, você precisará usar:
$ python3 --version.
Se o Python estiver instalado corretamente, você verá uma saída semelhante à seguinte: Python 3.9.1.
O número exibido pode variar, a depender de qual versão foi instalada em seu dispositivo.
Passo a passo: criar um ambiente virtual com venv
O módulo venv, incluído nas versões mais recentes do Python, facilita a criação e a gestão de ambientes virtuais, o que isola bibliotecas e dependências de cada projeto.
Muitos IDEs (Ambientes de Desenvolvimento Integrado) oferecem suporte à criação e à gestão desses ambientes virtuais, o que permite que você evite conflitos entre diferentes versões de bibliotecas em projetos distintos.
A seguir, confira o passo a passo para criar e utilizar esse espaço de isolamento, o que assegura um desenvolvimento mais organizado e eficiente.
Passo 1: escolher o diretório do ambiente virtual
Primeiro, você precisa decidir o local em que o seu ambiente virtual vai ficar. Pode ser em uma pasta que você já usa para os seus projetos Python ou, se preferir, um novo diretório criado especialmente para isso.
Passo 2: criar o ambiente virtual
No terminal, vá até o diretório que escolheu e execute o seguinte comando:
$ python3 -m venv nome_do_ambiente.
Nesse exemplo, o Python criará um ambiente virtual chamado “nome_do_ambiente”. Mas você pode escolher qualquer nome, basta modificá-lo no comando acima.
Em seguida, abra o seu terminal, navegue até o diretório escolhido e digite o seguinte comando:
$ python3 -m venv nome_do_ambiente.
Não se preocupe com o nome, você pode personalizá-lo como quiser. Por exemplo, se o trabalho é em um blog, poderia chamá-lo de “blog_venv” ou algo similar.
Esse comando cria o seu espaço isolado de desenvolvimento, pronto para receber todas as ferramentas necessárias para o seu projeto.
Passo 3: ativar o ambiente virtual
Após criar o ambiente virtual, é necessário ativá-lo para que as instalações de pacotes e execuções de scripts ocorram dentro desse ambiente isolado.
O procedimento varia conforme o sistema operacional. O comando de ativação costuma seguir o formato python venv activate, com pequenas variações de acordo com o sistema.
-
- No Windows: abra o Prompt de Comando e execute:
nome_do_ambiente\Scripts\activate;
- No macOS e Linux: abra o Terminal e execute:
-
source nome_do_ambiente/bin/activate.
- No Windows: abra o Prompt de Comando e execute:
O nome do ambiente virtual aparecerá no início do prompt, a fim de indicar que o ambiente está ativo.
Passo 4: instalar dependências dentro do ambiente
Com o ambiente virtual ativo, você pode instalar as bibliotecas necessárias para o seu projeto ao utilizar python venv install seguido pelo nome do pacote.
Por exemplo, para instalar a biblioteca requests, basta usar o comando:
pip install requests.
As bibliotecas instaladas dessa forma serão exclusivas do ambiente virtual, o que evita conflitos com outras instalações.
O comando python venv install ajuda a gerenciar as dependências dentro do ambiente de forma isolada e organizada.
Passo 5: desativar o ambiente virtual
Após encerrar o seu projeto, é hora de desativar o ambiente virtual e retornar ao ambiente global do Python.
O procedimento é bastante simples: basta executar o código
deactivate
O comando funciona tanto no Windows quanto no macOS e Linux.
Gerenciar dependências do projeto
Para que um projeto Python funcione de forma correta em diferentes ambientes, é fundamental gerenciar as suas dependências. Dessa forma, o trabalho colaborativo de desenvolvimento também fica mais fácil.
Uma prática comum e eficaz nessa gestão é o uso do arquivo requirements.txt. Veja, a seguir, como utilizá-lo.
Uso do requirements.txt
O requirements.txt é um arquivo de texto que lista todas as bibliotecas e suas versões necessárias para o projeto Python. Ao compartilhar esse arquivo, outros desenvolvedores podem replicar o ambiente e instalar as mesmas dependências nas versões especificadas.
Para gerar o requirements.txt, siga os passos abaixo:
-
- Ative o ambiente virtual do seu projeto por meio do seguinte comando para listar as dependências instaladas:
-
pip freeze > requirements.txt;
- Essa ação vai criar um arquivo requirements.txt que contém todas as bibliotecas instaladas no ambiente virtual, junto com as suas respectivas versões;
- Para instalar todas as dependências listadas no requirements.txt em um novo ambiente virtual, execute o código:
-
pip install -r requirements.txt;
- Assim, o arquivo requirements.txt será lido e todas as bibliotecas especificadas serão instaladas nas versões indicadas.
Dicas adicionais para ambientes virtuais
Ao trabalhar com ambientes virtuais em Python, principalmente em projetos colaborativos, é fundamental adotar práticas que garantam a organização e a eficiência do desenvolvimento.
A seguir, confira mais algumas dicas para otimizar o seu trabalho.
Como adicionar ao .gitignore
Para evitar que os arquivos do ambiente virtual sejam incluídos no controle de versão, é recomendável adicioná-los ao arquivo .gitignore. Isso mantém o repositório limpo e evita conflitos desnecessários.
No arquivo .gitignore, inclua a linha correspondente ao diretório do seu ambiente virtual.
Por exemplo, se o ambiente virtual estiver na pasta venv, adicione:
venv/.
Essa prática assegura que o diretório venv e o seu conteúdo sejam ignorados pelo Git.
Usar o venv em projetos colaborativos
Para que todos os desenvolvedores trabalhem com as mesmas dependências e versões de pacotes em projetos colaborativos, siga os passos abaixo:
1. Crie um ambiente virtual para o projeto com o comando:
python -m venv venv;
2. Ative o ambiente virtual — no Windows, utilize: venv\Scripts\activate; no macOS e Linux, use:
source venv/bin/activate;
3. Instale as dependências necessárias:
pip install nome_do_pacote;
4. Gere o arquivo requirements.txt com as dependências do projeto:
pip freeze > requirements.txt;
5. Compartilhe o arquivo requirements.txt no repositório;
6. Os colaboradores podem replicar o ambiente virtual localmente: crie e ative o ambiente virtual conforme os passos 1 e 2.
Instale as dependências a partir do requirements.txt:
pip install -r requirements.txt.
Ao seguir essas etapas, todos os membros da equipe trabalharão com as mesmas configurações, o que minimizará problemas de compatibilidade e facilitará a colaboração.
Agora que você já sabe como criar, ativar e gerenciar ambientes virtuais em Python com o venv, é hora de aplicar esses conhecimentos para organizar os seus projetos de forma mais eficiente.
A criação de ambientes isolados não só evita conflitos entre bibliotecas, como também facilita o trabalho em equipe e a manutenção de diferentes versões de pacotes.
Para mais dicas sobre organização e otimização de ambientes de desenvolvimento em Python, confira os nossos conteúdos exclusivos e potencialize ainda mais os seus projetos!