DEV Community

Francisco Júnior
Francisco Júnior

Posted on • Edited on

Guia Completo para Usar o Virtual Environment (venv) no Python

#python #programming #venv #beginners

Quando se trabalha em projetos Python, é comum lidar com diferentes versões de bibliotecas e dependências. Para garantir um ambiente de desenvolvimento limpo e organizado, o Python oferece uma ferramenta integrada chamada venv, que permite criar ambientes virtuais isolados. Neste artigo, vamos detalhar o que é o venv e como usá-lo com exemplos práticos.

O que é um Ambiente Virtual (Virtual Environment)?

Um ambiente virtual é uma instância independente do Python, que permite isolar as bibliotecas e dependências de um projeto específico. Isso é útil para evitar conflitos entre diferentes versões de pacotes e garantir que o projeto seja executado consistentemente, independentemente do ambiente de desenvolvimento.

Como Criar um Ambiente Virtual com o venv

O venv é uma biblioteca Python padrão, disponível nas versões 3.3 e posteriores. Para criar um ambiente virtual, siga os passos abaixo:

1. Abra um Terminal

Abra o terminal ou prompt de comando do seu sistema operacional.

2. Navegue até o Diretório do Projeto

Use o comando cd para navegar até o diretório raiz do seu projeto.

cd /caminho/do/seu/projeto
Enter fullscreen mode Exit fullscreen mode

3. Crie o Ambiente Virtual

Use o comando python -m venv nome_do_ambiente para criar um ambiente virtual com o nome desejado. Substitua nome_do_ambiente pelo nome que você escolher para o ambiente virtual.

python -m venv meu_ambiente_virtual
Enter fullscreen mode Exit fullscreen mode

4. Ative o Ambiente Virtual

Dependendo do seu sistema operacional, o comando para ativar o ambiente virtual varia:

No Windows:

meu_ambiente_virtual\Scripts\activate
Enter fullscreen mode Exit fullscreen mode

No macOS e Linux:

source meu_ambiente_virtual/bin/activate
Enter fullscreen mode Exit fullscreen mode

Você verá o nome do ambiente virtual atual no prompt do terminal, indicando que o ambiente foi ativado com sucesso.

Como Desativar um Ambiente Virtual

Para desativar um ambiente virtual e retornar ao ambiente global do Python, basta digitar:

deactivate
Enter fullscreen mode Exit fullscreen mode

Como Instalar Pacotes em um Ambiente Virtual

Com o ambiente virtual ativado, você pode instalar pacotes e bibliotecas específicos para o seu projeto sem afetar o ambiente global do Python. Use o comando pip para instalar pacotes:

pip install nome_do_pacote
Enter fullscreen mode Exit fullscreen mode

Por exemplo, para instalar a biblioteca requests em um ambiente virtual:

pip install requests
Enter fullscreen mode Exit fullscreen mode

Como Usar um Ambiente Virtual em um Projeto Python

Agora que o ambiente virtual está ativado e as bibliotecas necessárias estão instaladas, você pode executar seu projeto Python normalmente. Todas as dependências serão carregadas a partir do ambiente virtual.

Exemplo Prático

Vamos criar um exemplo simples de um projeto Python que usa um ambiente virtual.

  1. Crie um ambiente virtual chamado "meu_projeto". 
python -m venv meu_projeto
Enter fullscreen mode Exit fullscreen mode
  1. Ative o ambiente virtual. 
source meu_projeto/bin/activate  # No macOS e Linux
Enter fullscreen mode Exit fullscreen mode
  1. Instale uma biblioteca, como o Flask, em seu ambiente virtual. 
pip install flask
Enter fullscreen mode Exit fullscreen mode
  1. Crie um arquivo Python, como app.py, e escreva o seguinte código: 
from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, World!'

if __name__ == '__main__':
    app.run()
Enter fullscreen mode Exit fullscreen mode
  1. Execute o aplicativo Python. 
python app.py
Enter fullscreen mode Exit fullscreen mode

Agora, seu projeto Flask está em execução usando o ambiente virtual que você configurou.

Conclusão

O uso de ambientes virtuais com o venv é fundamental para manter a organização e evitar conflitos de dependências em projetos Python. Este guia detalhado fornece os passos necessários para criar, ativar e usar um ambiente virtual com exemplos práticos. Ao seguir essas práticas, você pode desenvolver projetos Python de forma mais eficiente e segura.

Top comments (2)

Collapse
 
henriquechav profile image
Henrique Chaves •

Mais uma dica útil: usar o comando pip freeze > requirements.txt.

Assim, um arquivo requirements.txt é criado com uma lista de todas as dependências instaladas e suas respectivas versões.

Com isso, outra pessoa pode criar um ambiente idêntico ao seu com o simples comando pip install -r requirements.txt.

Collapse
 
edvanbarbosa profile image
Edvan Barbosa • • Edited

Minha venv tá vindo sem o script de ativar

Read next

davidgsola profile image

8 tips to learn GenAI in 2025

David Sola -

mohosin2126 profile image

Setting Up C/C++ Development Environment in Visual Studio Code Using MinGW

Md Mohosin Ali Shah -

antonmak1 profile image

How the new concepts of JSSugar and JS0 are able to slow down websites

antonmak1 -

aadarshk7 profile image

What's new in Flutter 3.27

Aadarsh Kunwar -