Instalação e Configurações

Preparando o Ambiente

Antes de programar, precisamos preparar as ferramentas certas.


🛠️ Requisitos

O que você precisa

FerramentaObrigatórioDescrição
Python 3Linguagem de programação principal
VS CodeEditor de código moderno e gratuito
Python ExtensionExtensão oficial da Microsoft para VS Code
IPythonPrompt interativo melhorado (opcional)
Jupyter NotebookAmbiente para notebooks interativos (opcional)

Alternativa Online

Ao invés do VS Code, também é possível utilizar IDEs online como o Replit. Útil quando não é possível instalar programas no computador.

Versão mínima recomendada

Use sempre Python 3.10 ou superior. A versão mais recente estável em 2026 é a Python 3.13.x. Versões antigas podem não ter suporte a bibliotecas modernas.


🐍 Instalando Python no Windows

🔗 Python Brasil: Instalando o Python 3 no Windows 🔗 Download oficial Python.org

Passo a passo detalhado

  1. Acesse python.org/downloads e clique em Download Python 3.13.x.
  2. Execute o instalador baixado (.exe).
  3. IMPORTANTE: marque a opção “Add Python to PATH” antes de clicar em Install Now.
  4. Clique em Install Now e aguarde a instalação terminar.
  5. Clique em Close ao finalizar.

Não esqueça o PATH!

Se você não marcar “Add Python to PATH” durante a instalação, o terminal não vai reconhecer o comando python. Se isso acontecer, reinstale o Python marcando essa opção.

Verificar a versão instalada no terminal:

python --version

Resultado esperado (pode variar conforme a versão):

Python 3.13.3

🧪 Atividade 1: Instalar o Python e confirmar a versão

O que fazer:

  1. Baixe e instale o Python 3.13.x em python.org/downloads, marcando “Add Python to PATH”.
  2. Abra o Prompt de Comando (tecle Win + R, digite cmd, Enter).
  3. Digite o comando abaixo e pressione Enter:
python --version
  1. Agora execute o Python interativo e escreva um Hello World:
python

Dentro do interpretador, digite:

print("Olá, mundo!")

Resultado esperado: o terminal exibe Olá, mundo! na próxima linha. Para sair do interpretador, digite exit() e pressione Enter.


📦 Gerenciador de Pacotes (PIP)

O que é PIP?

O pip é o gerenciador de pacotes oficial do Python. Ele já vem instalado automaticamente junto com o Python 3. Com o pip você instala bibliotecas de terceiros, como NumPy, Pandas, Requests e milhares de outras disponíveis no PyPI.

🔗 pip: gerenciador de pacotes Python 🔗 Guia oficial de instalação de pacotes

Verificar a versão do pip:

pip --version

Instalar um pacote:

pip install nome-do-pacote

Instalar uma versão específica:

pip install requests==2.31.0

Listar pacotes instalados:

pip list

Desinstalar um pacote:

pip uninstall nome-do-pacote
Comando pipO que faz
pip install pacoteInstala o pacote mais recente
pip install pacote==x.yInstala versão específica
pip listLista todos os pacotes instalados
pip show pacoteMostra detalhes de um pacote
pip uninstall pacoteRemove o pacote
pip freeze > requirements.txtSalva lista de dependências em arquivo

🧪 Ambientes Virtuais (venv)

Por que usar ambientes virtuais?

Imagine dois projetos: um precisa da versão 1.0 de uma biblioteca e outro precisa da versão 2.0. Se instalarmos tudo no Python global, os dois vão entrar em conflito. O venv cria um Python isolado para cada projeto, resolvendo esse problema. É uma boa prática desde o início.

🔗 Documentação oficial: venv 🔗 Guia prático: pip e venv

Fluxo do ambiente virtual

flowchart TD
    A[📁 Pasta do Projeto] --> B[Criar venv\npython -m venv .venv]
    B --> C{Sistema Operacional?}
    C -- Windows --> D[Ativar\n.venv\\Scripts\\activate]
    C -- Linux/macOS --> E[Ativar\nsource .venv/bin/activate]
    D --> F[🟢 venv ativo\nprompt mostra .venv]
    E --> F
    F --> G[Instalar pacotes\npip install pacote]
    G --> H[Desenvolver o projeto]
    H --> I[Desativar quando terminar\ndeactivate]
    I --> J[🔴 venv desativado]

Comandos passo a passo

1. Criar o ambiente virtual (dentro da pasta do projeto):

python -m venv .venv

O nome .venv é uma convenção, mas você pode usar qualquer nome.

2. Ativar o ambiente virtual:

No Windows (Prompt de Comando):

.venv\Scripts\activate

No Linux/macOS:

source .venv/bin/activate

3. Confirmar que o venv está ativo:

O prompt do terminal vai mostrar (.venv) no início, assim:

(.venv) C:\Projetos\meu-projeto>

4. Instalar pacotes dentro do ambiente:

pip install requests

5. Desativar o ambiente quando terminar:

deactivate

🧪 Atividade 3: Criar um ambiente virtual e instalar um pacote

O que fazer:

  1. Crie uma pasta chamada meu-projeto na sua área de trabalho.
  2. Abra o terminal e navegue até ela:
cd Desktop\meu-projeto
  1. Crie o ambiente virtual:
python -m venv .venv
  1. Ative o ambiente:

Windows: .venv\Scripts\activate Linux/macOS: source .venv/bin/activate

  1. Instale o pacote requests:
pip install requests
  1. Confirme que foi instalado:
pip list

Resultado esperado: a lista mostra requests e suas dependências (certifi, charset-normalizer, urllib3).

  1. Desative o venv:
deactivate

💻 IPython (Opcional)

Prompt Interativo Melhorado

O IPython acrescenta recursos ao interpretador padrão do Python: realce de sintaxe colorido, autocompletar com Tab, histórico de comandos persistente entre sessões e exibição formatada de dados. Muito útil para explorar código e testar ideias rapidamente.

🔗 Instalando o IPython

Instalar o IPython:

pip install ipython

Iniciar o IPython:

ipython

🌐 IDE Online

Programar no Navegador

Se você não puder instalar nada no computador, use uma IDE online. O Replit permite criar projetos Python, escrever código e executar direto no navegador, sem instalar nada.

🔗 Replit: IDE colaborativa no navegador

IDE OnlineVantagem principal
ReplitSimples, colaborativo, suporta Python
Google ColabÓtimo para ciência de dados e notebooks
ProgramizMinimalista, ideal para iniciantes

📥 VS Code

🔗 Download Visual Studio Code: Mac, Linux, Windows

Por que usar o VS Code?

O Visual Studio Code (VS Code) é um editor de código gratuito, leve e extremamente popular. Ele funciona em Windows, Linux e macOS. Com extensões, vira uma IDE completa para Python com realce de sintaxe, autocompletar inteligente, depurador integrado e suporte a Git.

Passo a passo de instalação

  1. Acesse code.visualstudio.com/download.
  2. Clique em Windows (ou no seu sistema operacional).
  3. Execute o instalador baixado.
  4. Aceite o contrato de licença e clique em Próximo.
  5. Na etapa “Tarefas Adicionais”, marque “Adicionar ao PATH” e “Abrir com Code” (facilita abrir pastas pelo Explorer).
  6. Clique em Instalar e depois em Concluir.

Extensão obrigatória: Python (Microsoft)

Após instalar o VS Code, instale a extensão oficial do Python:

  1. Abra o VS Code.
  2. Clique no ícone de extensões na barra lateral (ou pressione Ctrl+Shift+X).
  3. Na barra de busca, digite Python.
  4. Clique em Install na extensão Python da Microsoft (ícone azul oficial).

Extensões recomendadas para Python

ExtensãoPublisherPara que serve
PythonMicrosoftSuporte completo a Python (obrigatória)
PylanceMicrosoftAutocompletar avançado e verificação de tipos
JupyterMicrosoftSuporte a notebooks .ipynb no VS Code
Python EnvironmentsMicrosoftGerenciamento visual de venvs (2025+)

🧪 Atividade 2: Instalar o VS Code e a extensão Python, depois rodar um Hello World

O que fazer:

  1. Instale o VS Code seguindo os passos acima.
  2. Abra o VS Code e instale a extensão Python da Microsoft (Ctrl+Shift+X, buscar “Python”, instalar).
  3. Crie um arquivo novo: Arquivo > Novo Arquivo e salve como hello.py.
  4. Digite o código abaixo no arquivo:
print("Olá, mundo! Estou programando no VS Code.")
  1. Execute o arquivo clicando no botão de play (triângulo) no canto superior direito, ou pressione Ctrl+F5.

Resultado esperado: o terminal integrado do VS Code abre na parte inferior e exibe:

Olá, mundo! Estou programando no VS Code.

🗺️ Visão Geral do Fluxo de Setup

flowchart LR
    A[🖥️ Computador\nsem configuração] --> B[1. Instalar Python 3.13\npython.org/downloads]
    B --> C[2. Verificar instalação\npython --version]
    C --> D[3. Instalar VS Code\ncode.visualstudio.com]
    D --> E[4. Instalar extensão Python\nCtrl+Shift+X]
    E --> F[5. Criar projeto\nnova pasta]
    F --> G[6. Criar venv\npython -m venv .venv]
    G --> H[7. Ativar venv\nactivate]
    H --> I[✅ Ambiente pronto\npara programar!]

📚 Fontes (2026)