Metade das frustrações de quem começa a aprender Python vem de configuração mal feita. Um ambiente bem configurado desde o início economiza horas de dor de cabeça. Este guia cobre a instalação correta do Python e do VS Code no Windows — a combinação mais usada por analistas de dados.

Instalando o Python

  1. Acesse python.org/downloads e baixe a versão mais recente (3.11 ou superior).
  2. Execute o instalador. IMPORTANTE: marque a opção "Add Python to PATH" antes de clicar em Install. Sem isso, o terminal não encontrará o Python.
  3. Clique em "Install Now".

Para verificar a instalação: abra o Prompt de Comando (Win+R, digite cmd) e digite:

python --version

Deve aparecer algo como Python 3.12.3. Se aparecer erro, o PATH não foi configurado corretamente — reinstale marcando a opção.

Instalando o VS Code

  1. Acesse code.visualstudio.com e baixe para Windows.
  2. Durante a instalação, marque "Adicionar ao PATH" e "Registrar código como editor para tipos de arquivo suportados".

Configurando o VS Code para Python

  1. Abra o VS Code.
  2. Vá em Extensões (Ctrl+Shift+X) e instale a extensão "Python" da Microsoft.
  3. Instale também "Pylance" para autocompletar inteligente.

Criando e rodando seu primeiro script

  1. Crie uma pasta para seus projetos Python (ex: C:\projetos-python).
  2. No VS Code: Arquivo → Abrir Pasta → selecione a pasta.
  3. Crie um novo arquivo: clique no ícone de novo arquivo → nomeie como primeiro_script.py.
  4. Digite o código:
print("Olá, Python!")
nome = "Analista de Dados"
print(f"Bem-vindo, {nome}!")
  1. Execute: pressione Ctrl+F5 ou clique no botão ▶ no canto superior direito.

O terminal integrado do VS Code abre e exibe a saída.

Ambientes virtuais: por que usar desde o início

Um ambiente virtual isola as bibliotecas de cada projeto. Sem ele, todas as bibliotecas vão para o Python global e projetos diferentes podem entrar em conflito.

# No terminal do VS Code (Ctrl+`):
python -m venv .venv
# Ativar no Windows:
.venv\Scriptsctivate
# Agora o prompt mostra (.venv) — você está no ambiente virtual

Perguntas frequentes

Devo usar o Jupyter Notebook ou o VS Code?

Para análise exploratória de dados e aprendizado, Jupyter Notebook (ou JupyterLab) é ótimo — você executa célula por célula e vê os resultados inline. Para scripts de automação e projetos maiores, VS Code é mais adequado. Muitos analistas usam os dois.

Qual versão do Python devo usar?

Sempre a versão estável mais recente (3.11, 3.12). Evite Python 2 — está descontinuado. Se precisar de compatibilidade com um sistema legado específico, use a versão que aquele sistema requer.