Python Brasil —...
Guia

PyCharm para Python: Configuração Completa

Aprenda a configurar o PyCharm para desenvolvimento Python. Instalação, atalhos, debugging, plugins e dicas para aumentar sua produtividade

6 min de leitura

Introdução

O PyCharm, desenvolvido pela JetBrains, é uma das IDEs mais completas para desenvolvimento Python. Diferente de editores mais leves como o VS Code, o PyCharm já vem com ferramentas integradas de debugging, refatoração, testes e suporte a frameworks como Django e Flask sem precisar de extensões adicionais.

Neste guia, vamos configurar o PyCharm do zero, explorar suas funcionalidades principais e aprender atalhos que aceleram o dia a dia de quem programa em Python.

Escolhendo a versão correta

O PyCharm está disponível em duas edições:

  • Community Edition: gratuita e de código aberto, ideal para desenvolvimento Python puro, scripts e projetos de ciência de dados.
  • Professional Edition: paga, com suporte completo a Django, Flask, FastAPI, bancos de dados, Docker, Jupyter Notebooks integrado e ferramentas de desenvolvimento web (HTML, CSS, JavaScript).

Para quem está começando, a Community Edition é mais que suficiente. Estudantes podem solicitar uma licença gratuita da Professional Edition pelo programa JetBrains Education.

Instalando o PyCharm

Download direto

Acesse jetbrains.com/pycharm e baixe a versão para seu sistema operacional. O instalador é simples e segue o padrão do seu sistema.

Usando o JetBrains Toolbox

A JetBrains recomenda usar o Toolbox App para gerenciar suas IDEs. Ele facilita atualizações e permite manter várias versões instaladas:

# No Linux, baixe e extraia o Toolbox
curl -fsSL https://download.jetbrains.com/toolbox/jetbrains-toolbox.tar.gz -o toolbox.tar.gz
tar -xzf toolbox.tar.gz
./jetbrains-toolbox-*/jetbrains-toolbox

No macOS, você também pode instalar via Homebrew:

brew install --cask jetbrains-toolbox

Configuração inicial

Escolhendo o interpretador Python

Ao criar ou abrir um projeto, o PyCharm pede para configurar o interpretador Python. Vá em File > Settings > Project > Python Interpreter (ou PyCharm > Preferences no macOS).

Você pode escolher entre:

  • Interpretador do sistema
  • Ambiente virtual (venv)
  • Conda
  • Poetry
  • Pipenv

A prática recomendada é criar um ambiente virtual para cada projeto:

python3 -m venv venv

O PyCharm detecta automaticamente ambientes virtuais na pasta do projeto e oferece ativá-los.

Tema e aparência

Para alterar o tema, acesse File > Settings > Appearance & Behavior > Appearance. O PyCharm vem com os temas Darcula (escuro) e IntelliJ (claro). Você pode instalar temas adicionais pelo marketplace de plugins.

Tamanho da fonte

Configure em File > Settings > Editor > Font. Um tamanho entre 14 e 16 pixels é confortável para a maioria dos monitores. Ative a opção Enable font ligatures se sua fonte suportar ligaduras.

Funcionalidades essenciais

Autocompletar inteligente

O PyCharm oferece autocompletar com inferência de tipos. Enquanto você digita, ele sugere métodos, atributos e variáveis com base no contexto:

texto = "Python Brasil"
texto.  # O PyCharm sugere upper(), lower(), split(), etc.

Use Ctrl + Espaço para forçar a exibição de sugestões. Para autocompletar com importação automática, use Ctrl + Shift + Espaço.

Os atalhos de navegação economizam muito tempo:

  • Ctrl + N (ou Cmd + O no macOS): buscar classe por nome
  • Ctrl + Shift + N: buscar arquivo por nome
  • Ctrl + B: ir para a definição de uma função ou classe
  • Alt + F7: encontrar todos os usos de um símbolo
  • Ctrl + E: arquivos recentes

Refatoração

O PyCharm é famoso por suas ferramentas de refatoração. Selecione uma variável ou função e pressione Shift + F6 para renomear em todos os lugares do projeto:

# Antes da refatoração
def calcular_total(itens):
    total = 0
    for item in itens:
        total += item.preco
    return total

# Renomear "calcular_total" para "somar_precos"
# O PyCharm atualiza todas as referências automaticamente

Outras refatorações disponíveis com Ctrl + Alt + Shift + T:

  • Extrair método
  • Extrair variável
  • Inline (substituir variável pelo valor)
  • Mover função para outro módulo

Debugging no PyCharm

O debugger integrado é um dos maiores diferenciais do PyCharm. Para usá-lo:

  1. Clique na margem esquerda do editor para adicionar um breakpoint (ponto de parada).
  2. Pressione Shift + F9 para executar em modo debug.
  3. Quando a execução parar no breakpoint, inspecione variáveis no painel inferior.
def fibonacci(n):
    if n <= 1:
        return n
    a, b = 0, 1
    for i in range(2, n + 1):  # Coloque um breakpoint aqui
        a, b = b, a + b
    return b

resultado = fibonacci(10)
print(resultado)

No painel de debug, você pode:

  • Step Over (F8): executar a próxima linha
  • Step Into (F7): entrar dentro de uma função
  • Step Out (Shift + F8): sair da função atual
  • Evaluate Expression (Alt + F8): testar expressões durante a execução

Plugins recomendados

Acesse File > Settings > Plugins para instalar plugins:

  • Rainbow Brackets: colore parênteses e colchetes para facilitar a leitura
  • .env files support: destaca sintaxe em arquivos .env
  • CSV Editor: visualiza arquivos CSV em formato de tabela
  • Key Promoter X: mostra o atalho de teclado quando você usa o mouse, ajudando a memorizar atalhos

Integração com controle de versão

O PyCharm tem suporte nativo a Git. O painel Version Control (ou Git) na parte inferior mostra alterações, histórico de commits e permite fazer merge visual.

Para clonar um repositório:

File > New > Project from Version Control

Cole a URL do repositório e o PyCharm faz o resto. Para commitar alterações, use Ctrl + K e para fazer push, Ctrl + Shift + K.

Terminal integrado

O PyCharm tem um terminal embutido acessível por Alt + F12. Ele já ativa automaticamente o ambiente virtual do projeto, então você pode executar comandos pip diretamente:

pip install requests
pip install flask
python manage.py runserver

Configurando o PyCharm para Django

Na Professional Edition, crie um projeto Django diretamente pelo assistente. Na Community Edition, configure manualmente:

pip install django
django-admin startproject meu_projeto .

Adicione um Run Configuration em Run > Edit Configurations com o script manage.py e o parâmetro runserver.

Dicas de produtividade

  • Ctrl + D: duplicar a linha atual
  • Ctrl + Y: deletar a linha atual
  • Ctrl + /: comentar ou descomentar a linha
  • Ctrl + Shift + F: buscar em todo o projeto
  • Ctrl + Alt + L: reformatar o código seguindo o PEP 8
  • Shift + Shift (duplo Shift): busca universal — encontra arquivos, classes, ações e configurações

Use o recurso Scratches (Ctrl + Alt + Shift + Insert) para criar arquivos temporários onde você pode testar trechos de código sem afetar seu projeto.

Conclusão

O PyCharm é uma IDE poderosa que oferece tudo o que um desenvolvedor Python precisa em um único lugar. Suas ferramentas de refatoração, debugging e navegação são superiores às da maioria dos editores. Para projetos maiores e equipes que trabalham com frameworks como Django e Flask, o investimento na Professional Edition se paga rapidamente. Para projetos menores e aprendizado, a Community Edition é uma excelente escolha gratuita.

Todos os Guias