Configuração do ambiente de desenvolvimento

7.1 Baixando o PyCharm

«Para escrever programas, é preciso escrever programas». Há definitivamente lógica nessa citação. Mas para iniciar esse processo, é necessário instalar um ambiente de desenvolvimento IDE (PyCharm), conectar o Python SDK e criar o primeiro projeto. Vamos começar por isso.

Passo 1. Primeiro é preciso baixar o PyCharm. Digite PyCharm na pesquisa do Google ou simplesmente siga o link direto para o site do desenvolvedor.

Passo 2. Clique sem medo no botão Download. Anteriormente, os usuários tinham que escolher entre as versões paga e gratuita, mas agora o PyCharm tornou-se um programa único.

Passo 3. O site detectará automaticamente seu sistema operacional. Se isso não acontecer, selecione-o manualmente na parte superior da página.

Recursos da versão PyCharm 2025.3

Desde 2025, o PyCharm tornou-se um produto único, então você não precisa mais se preocupar em escolher a versão ao baixar. A principal novidade é que o suporte para Jupyter Notebook, bancos de dados e linguagem SQL agora é gratuito. Você pode se conectar a bancos de dados e escrever consultas diretamente na versão básica do programa sem comprar uma assinatura.

7.2 Instalação do PyCharm

Após o download, execute o arquivo de instalação. A instalação é rápida:

Instalação no macOS

No macOS, o processo é o mais simples possível. Abra o arquivo baixado e arraste o ícone do PyCharm para a pasta Applications. Tudo pronto. Agora execute o programa através do Launchpad ou da pesquisa Spotlight, como qualquer outro aplicativo.

Após a instalação, o PyCharm pode oferecer a importação de configurações de versões antigas. Se você estiver instalando o ambiente de desenvolvimento pela primeira vez, não terá nada para importar. Sinta-se à vontade para escolher Skip Import. Isso garante um início limpo sem problemas desnecessários.

7.3 Criação do primeiro projeto

Resta apenas iniciar o PyCharm e preparar o espaço de trabalho.

Na primeira inicialização, você pode ativar o mês de teste do modo Pro. Quando o teste terminar, o PyCharm oferecerá a compra de uma assinatura ou a permanência na versão gratuita. Para o nosso curso, você não precisa comprar nada — as ferramentas básicas serão mais do que suficientes.

Passo 1. A janela de inicialização será aberta diante de você.

A interface é dividida em três zonas lógicas, cada uma responsável por suas próprias tarefas.

Painel esquerdo: gerenciamento de projetos

Aqui está sua lista de trabalhos recentes. Se você estiver abrindo o PyCharm pela primeira vez, esta lista estará vazia. No topo estão três botões principais:

• Open permite abrir uma pasta existente com código em seu computador.
• New inicia o assistente para criar um novo projeto do zero.
• Clone Repository é útil para baixar código de fontes remotas, como o GitHub.

Área central:

Esta zona foi criada para um início imediato do trabalho sem longas configurações. Aqui estão os botões para as ações mais frequentes:

• New Script cria um arquivo temporário para escrever código. Isso é conveniente se você precisar verificar rapidamente uma ideia e não quiser criar um projeto inteiro.
• New Notebook abre cadernos interativos Jupyter. Anteriormente, esse recurso era pago, mas agora está disponível para todos para trabalhar com dados e gráficos.
• Import File permite carregar um arquivo específico no editor.
• Learn inicia um curso interativo integrado que ensinará você a usar teclas de atalho e técnicas de refatoração.
• Plugins abre a loja de complementos, onde você pode encontrar novos temas de design ou ferramentas para oferecer suporte a outros idiomas.

3. Painel inferior

Na parte inferior da tela, você pode adaptar imediatamente o PyCharm para si mesmo. O menu Theme permite alternar o esquema de cores se o tema escuro padrão não agradar você. Ao lado está a configuração Keymap, onde você pode escolher um layout de teclado familiar.

Lá também está o interruptor Enable non-modal Welcome screen. Por padrão, a janela de inicialização funciona como menu principal e não dá acesso aos painéis superiores do programa até que você abra um projeto. Se você ativar essa configuração, a janela de boas-vindas se comportará como uma guia normal. Isso permitirá que você use livremente o menu principal na parte superior e altere as configurações do ambiente antes mesmo de começar a escrever código.

Passo 2. Para criar um projeto, clique no botão + New... - New Project... (painel esquerdo). No menu, configure os parâmetros:

As configurações devem ser mais ou menos assim:

• Pure Python — no menu esquerdo, exatamente este item deve estar selecionado. Este é o modo padrão para criar aplicativos clássicos sem complementos desnecessários.
• Location — aqui você indica o caminho onde seu projeto ficará. Observe que não há um campo separado para o nome aqui. O nome do seu projeto será a última palavra nesta linha pythonProject.
• Create a welcome script — se você ativá-lo, o PyCharm criará automaticamente um arquivo main.py com o código mais simples. Isso permitirá que você execute o programa imediatamente e verifique se tudo funciona.
• Interpreter type — aqui o Project venv está definido por padrão. Deixe essa configuração inalterada. Ela cria um ambiente virtual isolado para o seu projeto. Isso significa que as bibliotecas que você instalar aqui não entrarão em conflito com seus outros projetos.
• Python version — certifique-se de que a versão 3.12 ou 3.13 esteja selecionada aqui. Se não estiver selecionada, abra a lista suspensa. O PyCharm pode baixar e instalar a versão necessária do Python sozinho, se ela não estiver no computador.

Depois de verificar todos os pontos, pressione com confiança o botão azul Create

Você também pode notar outras opções de configuração do ambiente:

• uv — este é um gerenciador de pacotes moderno e muito rápido. Ele funciona na velocidade da luz, mas para começar, seus recursos podem parecer excessivos.
• Base conda é útil para quem trabalha com ciência de dados e já instalou a distribuição Anaconda. Esta é a escolha padrão para analistas e engenheiros de Data Science.
• Custom environment é necessário para uma configuração totalmente manual. Este item é escolhido por desenvolvedores experientes que desejam conectar um intérprete existente específico ou usar ferramentas específicas de gerenciamento de dependências.

Mas lembre-se de que, para nosso aprendizado, a escolha ideal e mais confiável continua sendo o padrão Project venv.

Passo 3. O download automático do Python começará. Isso levará alguns minutos.

Passo 4. Se tudo foi feito corretamente, o editor de código será aberto com seu primeiro arquivo. Parabéns!

1. Indexação do projeto

No centro do painel inferior, você verá um indicador de carregamento. Nesse momento, o PyCharm verifica todos os arquivos do seu projeto e as bibliotecas Python. O programa constrói um mapa do seu código para encontrar instantaneamente as classes necessárias e fornecer dicas inteligentes. Até que essa barra desapareça, o ambiente de desenvolvimento pode funcionar um pouco mais lento do que o normal. Apenas dê alguns minutos para terminar esse processo.

2. Verificação do intérprete

No canto inferior direito, o status da conexão Python é exibido. Se você vir uma inscrição como Python 3.XX lá, significa que a instalação foi bem-sucedida. O ambiente de desenvolvimento vê o intérprete e está pronto para executar seus comandos.

Se disser No interpreter, na próxima palestra analisaremos como corrigir isso.

Para usuários do Windows

No canto inferior direito, pode aparecer uma janela pop-up com um aviso sobre o Microsoft Defender. O fato é que o antivírus integrado do Windows verifica cada arquivo do projeto em tempo real, o que retarda muito o funcionamento do PyCharm. Clique sem medo no botão Automatically ou Exclude folders nesta notificação. Isso adicionará a pasta do projeto às exceções do antivírus e acelerará significativamente a inicialização dos programas.

7.4 Redefinição para as configurações de fábrica

Se você clicou acidentalmente em algo errado, a interface ficou estranha ou o programa se comporta de maneira incomum, não é necessário reinstalá-lo. Você pode simplesmente retornar tudo ao estado original.

Vá para o menu File, selecione Manage IDE Settings e clique em Restore Default Settings. O programa será reiniciado e ficará absolutamente limpo, como no primeiro dia. Esta é a maneira mais rápida de corrigir quaisquer erros na configuração.