--- title: "PyCharm para Python: Configuração Completa" url: "https://python.dev.br/guias/configurando-pycharm/" markdown_url: "https://python.dev.br/guias/configurando-pycharm.MD" description: "Aprenda a configurar o PyCharm para desenvolvimento Python. Instalação, atalhos, debugging, plugins e dicas para aumentar sua produtividade" date: "2025-11-10" author: "" --- # 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 ## 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](https://www.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: ```bash # 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: ```bash 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: ```bash 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: ```python 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`. ### Navegação rápida 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: ```python # 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. ```python 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: ```bash 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: ```bash 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. A JetBrains oferece IDEs especializadas para outras linguagens com a mesma qualidade. Conheça o desenvolvimento com GoLand para Go ou explore o IntelliJ IDEA para Kotlin, linguagem criada pela própria JetBrains.