Este guia foi fortemente inspirado por Jack Fields e pelo artigo dele sobre como configurar o VS Code para desenvolvimento em Python. Dá uma olhada no artigo para mais detalhes.

Pré-requisitos

Antes de começar, garante que tu tens:
  • Python instalado (recomendado 3.8 ou superior)
  • Git para controle de versão
  • Cursor instalado e atualizado para a versão mais recente

Extensões essenciais

As extensões abaixo deixam o Cursor completo para desenvolvimento em Python. Elas te oferecem realce de sintaxe, linting, depuração e testes de unidade.

Ferramentas avançadas para Python

Embora as extensões acima tenham sido, até recentemente, as mais populares para desenvolvimento em Python no Cursor, a gente também adicionou outras que podem te ajudar a tirar o máximo do teu fluxo de trabalho em Python.

uv - Gerenciador de ambientes Python

uv é um gerenciador de pacotes moderno para Python que pode ser usado para criar e gerenciar ambientes virtuais, além de substituir o pip como gerenciador de pacotes padrão. Para instalar o uv, roda o seguinte comando no teu terminal:
pip install uv

ruff - Linter e formatador para Python

Ruff é um linter e formatador moderno para Python que pode verificar erros de programação, ajudar a impor padrões de código e sugerir refatorações. Ele pode ser usado junto com o Black para formatação de código. Para instalar o Ruff, roda o seguinte comando no teu terminal:
pip install ruff

Configuração do Cursor

1. Interpretador do Python

Configura teu interpretador do Python no Cursor:
  1. Abre a Command Palette (Cmd/Ctrl + Shift + P)
  2. Busca por “Python: Select Interpreter”
  3. Escolhe teu interpretador do Python (ou o ambiente virtual, se estiver usando)

2. Formatação de código

Configura a formatação automática de código com o Black:
O Black é um formatador que ajusta teu código automaticamente para seguir um estilo consistente. Não requer configuração e é amplamente adotado na comunidade Python.
Pra instalar o Black, roda o seguinte comando no teu terminal:
pip install black
Depois, configura o Cursor pra usar o Black na formatação de código, adicionando o seguinte ao teu arquivo settings.json:
{
  "python.formatting.provider": "black",
  "editor.formatOnSave": true,
  "python.formatting.blackArgs": ["--line-length", "88"]
}

3. Linting

A gente pode usar o PyLint pra verificar erros de programação, ajudar a aplicar padrões de código e sugerir refatorações. Pra instalar o PyLint, roda o seguinte comando no teu terminal:
pip install pylint
{
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.linting.lintOnSave": true
}

4. Verificação de tipos

Além do linting, a gente pode usar o MyPy pra checar erros de tipo. Pra instalar o MyPy, roda o seguinte comando no teu terminal:
pip install mypy
{
  "python.linting.mypyEnabled": true
}

Depuração

O Cursor oferece recursos poderosos de depuração para Python:
  1. Define pontos de interrupção clicando na margem
  2. Usa o painel Debug (Cmd/Ctrl + Shift + D)
  3. Configura o launch.json para depurações personalizadas

Suporte a frameworks

O Cursor funciona perfeitamente com frameworks populares do Python:
  • Web: Django, Flask, FastAPI
  • Data Science: Jupyter, NumPy, Pandas
  • Machine Learning: TensorFlow, PyTorch, scikit-learn
  • Testes: pytest, unittest
  • APIs: requests, aiohttp
  • Banco de dados: SQLAlchemy, psycopg2