Entender ambientes e pacotes
Tip
Consulte a guia Texto e imagens para obter mais detalhes!
Python tem um enorme ecossistema de pacotes de terceiros— bibliotecas de código reutilizáveis que estendem o que Python pode fazer. Antes de instalar pacotes, é uma boa prática configurar um ambiente virtual para que as dependências do projeto permaneçam organizadas e não interfiram em outros projetos.
O que é um ambiente virtual?
Um ambiente virtual é uma pasta isolada que contém sua própria cópia de Python e todos os pacotes instalados. Pense nele como um workspace limpo para cada projeto— os pacotes instalados em um ambiente não afetam outro.
Criar um ambiente virtual
No VS Code, abra o terminal integrado (Terminal > Novo Terminal) e navegue até a pasta do projeto. Em seguida, execute:
python -m venv .venv
Esse comando cria uma pasta oculta chamada .venv que contém o ambiente isolado. Ative-o com:
| Platform | Comando |
|---|---|
| Windows | .venv\Scripts\activate |
| macOS/Linux | source .venv/bin/activate |
Quando estiver ativo, você verá (.venv) aparecer no início do prompt do terminal. Você também pode usar o Python: Select Interpreter comando no VS Code para criar e ativar um ambiente virtual.
Instalar pacotes com pip
pip é o gerenciador de pacotes interno do Python. Depois que o ambiente virtual estiver ativo, use-o para instalar pacotes:
pip install requests
Para ver todos os pacotes instalados no ambiente atual:
pip list
Para salvar as dependências do projeto, para que outras pessoas possam recriar o ambiente:
pip freeze > requirements.txt
E para instalar a partir desse arquivo:
pip install -r requirements.txt
Tip
O VS Code detecta seu ambiente virtual automaticamente. Ao abrir um arquivo Python, procure a versão Python na barra de status inferior, selecione-a para escolher seu .venv ambiente se ele ainda não estiver selecionado.