Primeiro projeto

8.1 Explorando a estrutura da IDE

Então, criamos um novo projeto. Vamos entender o que estamos vendo aqui.

1. A árvore de pastas e arquivos do projeto:

Aqui mostramos o conteúdo da pasta do nosso projeto — pythonProject.

2. Arquivo aberto atualmente:

Isso é apenas o conteúdo do arquivo main.py, com a sintaxe do código destacada.

3. Na parte superior — o menu principal:

Botões úteis à direita no topo:

• «Triângulo verde» — botão para iniciar o projeto.
• «Besouro» — botão para iniciar o modo de depuração.
• «Lupa» — pesquisa no projeto.
• «Engrenagem» — configurações.

4. À esquerda você vê o menu lateral:

Aqui há vários botões úteis, em particular, estaremos interessados no botão Terminal.

5. Barra de status:

À esquerda na barra de status é mostrado o caminho do arquivo aberto atualmente. À direita — sua codificação: CRLF, UTF-8.

E mais à direita é exibida a versão atual do Python — Python 3.12.x, em que nosso projeto será executado. Pode ser útil dar uma olhada aqui se você tiver várias versões diferentes do Python instaladas no seu computador e houver projetos que trabalham com outras versões.

8.2 Análise do projeto

Um projeto comum consiste em arquivos que são exibidos no painel esquerdo. Esses arquivos podem ser divididos condicionalmente em 4 partes.

Arquivos com código em linguagem Python. Tais arquivos têm a extensão .py e o PyCharm os marca com um ícone azul e amarelo. Em nosso projeto agora há apenas um arquivo desse tipo — main.py

Arquivos estáticos. Assim são chamados os arquivos que contêm dados, mas não código. Podem ser arquivos de texto, imagens, arquivos de mídia e assim por diante. Agora não há nenhum em nosso projeto.

Ambiente virtual Python. Na pasta chamada .venv (abreviação de Virtual Environment) estão contidos os arquivos Python, bem como vários utilitários de serviço. É aqui que o gerenciador de pacotes pip carregará bibliotecas de terceiros que você queira usar.

Bibliotecas de terceiros (External libraries). Agora não há nenhuma em nosso projeto, mas quando você as baixar, o PyCharm certamente as exibirá aqui.

8.3 Ambiente virtual .venv

Vamos falar um pouco mais detalhadamente sobre o ambiente virtual. .venv é um módulo em Python que oferece a possibilidade de criar diferentes ambientes virtuais leves e isolados para projetos Python. É uma ferramenta que permite gerenciar as dependências do projeto, isolando-as das bibliotecas do sistema. Imagine que é um quarto isolado para o seu projeto, onde ele pode guardar seus brinquedos e ferramentas pessoais sem incomodar os outros moradores da casa.

Tecnicamente, isso funciona de forma simples: dentro da pasta do projeto é criada uma cópia do interpretador Python e um lugar separado para bibliotecas. Isso garante que, se você instalar alguma versão específica de uma biblioteca para um projeto, ela não quebrará outro que precise de uma versão mais antiga. O uso de um ambiente virtual é uma regra de bom tom que salva de conflitos de versões intermináveis.

Gerenciamento de ambiente no PyCharm

O PyCharm geralmente cuida disso sozinho e cria tudo automaticamente. Mas acontece que você excluiu acidentalmente a pasta necessária ou simplesmente quer começar tudo do zero. Saber gerenciar essas configurações manualmente é uma habilidade útil.

Criando um ambiente

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

Se estiver escrito No interpreter, clique nessa inscrição.

1. No menu que aparece, selecionamos Add New Interpreter e depois Add Local Interpreter.
2. Nas configurações à esquerda, selecionamos Environment. No centro, certifique-se de que a caixa de seleção em Generate New esteja marcada.
3. Pressionamos OK. O editor criará uma nova pasta .venv e mudará imediatamente o projeto para ela. Agora você tem um sistema absolutamente limpo sem lixo desnecessário.

Excluindo o antigo ou desnecessário

Às vezes, os experimentos chegam a um beco sem saída, e é mais fácil excluir o ambiente do que tentar consertá-lo. Veja como fazer isso:

1. Clicamos novamente na versão do Python no canto inferior direito e selecionamos o item Interpreter Settings.
2. No topo, procuramos o campo Python Interpreter. Abrimos a lista e selecionamos o item Show All.
3. Você verá uma lista de todos os ambientes que o PyCharm conhece. Selecione aquele que deseja remover e pressione o botão com o sinal de menos no menu acima da lista.
4. Um ponto importante: o PyCharm simplesmente "esquecerá" desse ambiente e parará de usá-lo. Para liberar fisicamente espaço no disco, você precisa ir para a pasta do projeto através do explorador de arquivos comum e excluir a pasta .venv manualmente.

Criação de um segundo ambiente

Erro: "Already contains Python"

Se você entrar no menu de adicionar interpretador e selecionar Generate new, o PyCharm pode mostrar um aviso vermelho e bloquear o botão OK. Isso acontece porque o editor, por hábito, tenta criar um novo ambiente na mesma pasta .venv que já está ocupada pelo seu primeiro ambiente. Dois conjuntos diferentes de bibliotecas não podem viver em uma única pasta.

Como corrigir isso

Basta dar ao novo "sandbox" um nome único. Veja como fazer isso:

1. Abra o menu Add Local Interpreter, como fizemos antes.
2. Selecione o item Generate new.
3. Olhe para o campo Location. Provavelmente, o caminho lá termina com o nome padrão \.venv.
4. Coloque o cursor no final da linha e simplesmente adicione qualquer dígito lá. Altere o final do caminho para \.venv_2 e pressione Enter.
5. A inscrição vermelha desaparecerá imediatamente. Pressione OK.

Agora, em seu projeto, existirão fisicamente duas pastas diferentes com configurações, e o PyCharm mudará automaticamente para a nova versão.

Como alternar entre ambientes

A capacidade de fazer malabarismos com ambientes é uma habilidade importante. Mas há uma pegadinha aqui: o PyCharm nem sempre se lembra dos seus ambientes antigos automaticamente.

Muitas vezes acontece que você criou um segundo ambiente, e o primeiro desapareceu do menu, embora a pasta .venv ainda esteja no projeto. Nesse caso, você simplesmente precisa indicar ao PyCharm onde procurar o Python antigo. Exemplo para alternar de .venv_2 para .venv:

1. Clique na versão do Python no canto e selecione Add New Interpreter -> Add Local Interpreter.
2. Na janela que aparece, mude o ponto para o item Select Existing.
3. No campo Python Path, clique no ícone da pasta à direita.
4. Agora você precisa encontrar o arquivo de inicialização do Python em sua pasta antiga (.venv). Siga o caminho: Seu_projeto -> .venv -> Scripts (para Windows) ou bin (para macOS/Linux).
5. Dentro dessa pasta, selecione o arquivo python e pressione OK.

Agora o ambiente antigo aparecerá novamente nas configurações e se tornará ativo. Este método funciona sem falhas, mesmo se o PyCharm "esqueceu" suas configurações.

8.4 Trabalhando com o terminal

No PyCharm você pode trabalhar com a linha de comando do sistema operacional diretamente. No Linux e MacOS a linha de comando é chamada de Terminal, por isso o PyCharm também a chama assim. Embora, na verdade, isso não seja uma peculiaridade do PyCharm, mas um nome consolidado entre os programadores.

Para abrir o Terminal você precisa clicar no botão terminal no menu lateral:

Você deve ver uma janela assim:

Nesta janela você pode digitar comandos do seu sistema operacional. Estamos interessados em um deles.

Vamos descobrir a versão atual do interpretador Python que instalamos. Para isso, precisamos digitar:

        python --version

Veja o que apareceu para mim:

Se você também viu Python 3.12.x, significa que estamos no caminho certo.