O guia que eu gostaria de ter encontrado antes de quebrar minhas bibliotecas Python
Olá devs! 💜
Olha que assunto interessante dessa semana!
Você acabou de instalar o Python no seu computador e está super empolgada estudando desenvolvimento web e análise de dados.
Você começa a instalar dezenas de bibliotecas incríveis usando o comando pip install e tudo funciona perfeitamente.
Algumas semanas depois, você tenta rodar um projeto antigo e ele simplesmente para de funcionar com erros confusos dizendo que certas funções sumiram ou mudaram de comportamento.
Quem nunca? 😂
Esse é o clássico pesadelo da “bagunça global de dependências”.
Instalar todas as bibliotecas no sistema operacional inteiro de uma vez gera conflitos de versões que travam seus projetos.
Felizmente, o Python tem uma ferramenta nativa perfeita para resolver isso: os ambientes virtuais (conhecidos como venv)!
🥰 Siga nossa página no Linkedin e no Instagram e ajude a divulgar nosso conteúdo. Por mais mulheres em tech!
Veja também:
- 8 plugins do Obsidian que você deveria conhecer
- 8 mulheres de destaque na computação
- 10 termos chave sobre carreira em TI que você deve conhecer
- O Gemini agora cria um plano de estudos personalizado para você
O que é um ambiente virtual? (A analogia das caixas organizadoras)
Para entender como funciona o ambiente virtual, imagine que você está organizando diferentes projetos de artesanato na sua casa.
- Instalação Global: É como jogar todas as tintas, pincéis, colas e tecidos de todos os seus projetos dentro de uma única gaveta gigante na cozinha. Eventualmente, as tintas vão vazar, os tecidos vão manchar e você não vai conseguir encontrar as ferramentas certas para cada artesanato específico.
- Ambiente Virtual (venv): É como separar caixas organizadoras plásticas para cada projeto. A caixa “Pintura em Tela” tem suas tintas específicas, enquanto a caixa “Costura” tem suas agulhas e linhas. O que está dentro de uma caixa não interfere na outra de jeito nenhum.
No Python, o ambiente virtual é exatamente essa caixa organizadora digital:
Uma pasta oculta no seu projeto que contém uma cópia isolada do interpretador Python e de todas as bibliotecas de que aquele projeto específico necessita.
Como usar o venv na prática? Passo a passo no terminal
Criar e gerenciar um ambiente virtual é muito simples e exige apenas três comandos básicos no terminal do seu VS Code:
- Criação: Acesse a pasta do seu projeto pelo terminal e execute o comando:
No Windows:
python -m venv .venvNo Mac/Linux:
python3 -m venv .venv(Isso cria uma pasta chamada .venv na raiz do seu projeto contendo o ambiente isolado).
- Ativação: Você precisa dizer ao terminal para usar essa “caixa organizadora” específica:
No Windows (PowerShell):
.venv\Scripts\Activate.ps1No Windows (CMD):
.venv\Scripts\activateNo Mac/Linux:
source .venv/bin/activateVocê saberá que deu certo porque o nome (.venv) aparecerá destacado no início da linha do terminal:
(.venv) C:\Projetos\meu_projeto>- Instalação segura: Agora, qualquer
pip installque você rodar (ex:pip install pandas) instalará a biblioteca exclusivamente dentro dessa pasta.venv, sem mexer nas configurações globais do seu computador.
A regra de ouro do venv: requirements.txt
Como a pasta .venv pode ficar gigante com centenas de arquivos de terceiros, ela nunca deve ser enviada para o GitHub (adicione .venv no seu .gitignore).
Para salvar a lista de ferramentas que seu projeto precisa, usamos o arquivo requirements.txt:
- Para salvar as dependências instaladas:
pip freeze > requirements.txt- Quando outra pessoa baixar seu projeto, ela só precisará criar o ambiente virtual dela e rodar:
pip install -r requirements.txtOutras opções para gerenciar ambientes Python
O venv é a ferramenta padrão da biblioteca do Python e, para a maioria dos projetos, é a melhor escolha para começar. Mas existem outras alternativas bastante utilizadas:
- uv: ferramenta moderna e extremamente rápida que gerencia ambientes virtuais e dependências, além de substituir o
pipem muitos cenários. - Anaconda/Miniconda: muito popular em Ciência de Dados e Machine Learning, pois também gerencia bibliotecas nativas e diferentes versões do Python.
- Poetry: além de criar ambientes virtuais, gerencia dependências, empacotamento e publicação de projetos.
- Rye (menos comum atualmente) e outras ferramentas surgem com propostas semelhantes de simplificar o fluxo de desenvolvimento.
Independentemente da ferramenta escolhida, o conceito é o mesmo:
Isolar as dependências de cada projeto para evitar conflitos e tornar o ambiente reproduzível.
Por que isso é importante para sua carreira?
Organização de código e gerenciamento de dependências são características indispensáveis de quem desenvolve de forma profissional.
Ao criar o hábito de usar ambientes virtuais desde seus primeiros projetos de estudos, você demonstra cuidado com a infraestrutura local, organização técnica e respeito às boas práticas do ecossistema Python.
Se você está começando, aprenda primeiro o
venv. Depois, quando precisar de mais velocidade ou recursos, vale conhecer ferramentas comouvouAnacondapara casos específicos.
No mercado corporativo, criar projetos em ambientes isolados é esesncial, então praticar isso desde cedo vai facilitar muito o seu dia a dia e te deixar pronta para qualquer time profissional!
💬 Agora me conta: você já costuma usar ambientes virtuais?
