Ambientes Virtuais em Python

Quando começamos a programar em Python, muitas vezes instalamos pacotes diretamente no sistema com o pip. Isso funciona em projetos pequenos, mas rapidamente gera um problema: conflito de versões.

Imagine que você tem dois projetos diferentes:

• Um precisa da biblioteca pandas na versão 1.3.
• Outro depende do pandas na versão 2.0.

Se você instalar os dois no mesmo ambiente, o Python não saberá qual versão usar. É aí que entram os ambientes virtuais.

---

O que é um ambiente virtual?

Um ambiente virtual é um espaço isolado dentro do seu computador que contém a sua própria instalação de Python e bibliotecas. Cada projeto pode ter seu próprio ambiente, com dependências específicas, sem afetar os outros.

Benefícios principais:

• Evita conflitos de versões.
• Mantém os projetos organizados.
• Facilita a reprodução do ambiente em outros computadores.

---

Lista de ambientes virtuais Python

• venv: simples e padrão, ótimo para começar.
• virtualenv: alternativa ao venv, mais flexível em versões antigas.
• pipenv: ambientes virtuais + gerenciamento de pacotes com Pipfile.
• poetry: moderno, profissional, voltado para projetos organizados e publicação.
• conda: ciência de dados, machine learning e pacotes pesados.
• pyenv: troca fácil de versões do Python + ambientes isolados.

---

Criando ambientes virtuais com venv

O Python já vem com um módulo embutido chamado venv, que permite criar ambientes virtuais de forma simples.

1. No terminal, navegue até a pasta do projeto e digite:

python -m venv venv

• O primeiro venv faz parte do comando para criar o amviente virtual, o segundo é o nome do diretório que será criado no projeto.
• Após esse comando, será criada uma pasta chamada venv/ com toda a estrutura do ambiente.

---

2. Antes de instalar pacotes, é preciso ativar o ambiente.

.\venv\Scripts\Activate.ps1   	   # Windows(PowerShell)
venv\Scripts\activate.bat	   # Windows (CMD)
source venv/bin/activate	   # Linux/macOS:

Ao ativar, o terminal exibirá algo como:

(venv) C:/projetos/meu_projeto>

O (venv) indica que o ambiente está ativo.

---

3. Quando o ambiente estiver ativo, é necessário criar o arquivo requirements.txt.

pip freeze > requirements.txt   

• Este comando gera (ou atualiza) o arquivo de dependências

---

4. Agora você pode instalar bibliotecas sem afetar o sistema:

pip install pandas
pip install requests

• Esses pacotes ficam disponíveis somente dentro do ambiente virtual..

---

5. Quando terminar de trabalhar, basta desativar:

deactivate

---

Comandos importantes

python -m venv venv               # Cria um ambiente virtual
venv\Scripts\activate             # Ativa o ambiente no Windows
source venv/bin/activate          # Ativa o ambiente no Linux/macOS
deactivate                        # Encerra o ambiente virtual

pip install nome-pacote           # Instala um pacote
pip uninstall nome-pacote         # Remove um pacote
pip freeze > requirements.txt     # Gera (ou atualiza) o arquivo de dependências
pip install -r requirements.txt   # Instala pacotes listados no requirements.txt
pip list                          # Lista pacotes instalados
pip show nome-pacote              # Exibe detalhes de um pacote

---

Conclusão

Usar ambientes virtuais em Python é uma prática essencial para qualquer desenvolvedor. Com o venv, cada projeto tem suas próprias dependências, organizadas e livres de conflitos. Muito obrigado e até a próxima.

Documentação Python - venv: https://docs.python.org/pt-br/3/library/venv.html