Como criar um projeto Python com o VS Code

Editado 2 dias atrás por ExtremeHow Equipe Editorial

PythonVisual Studio CodeVS CodeIDEConfiguração do projetoJanelasMacLinuxFerramentas de programaçãoDesenvolvimento

Criar um projeto Python usando o Visual Studio Code (VS Code) é um processo direto que pode beneficiar tanto iniciantes quanto programadores experientes. O VS Code é um editor de código versátil e leve desenvolvido pela Microsoft que suporta várias linguagens de programação, especialmente Python. Oferece recursos como depuração, execução de tarefas, controle de versão e um extenso mercado para extensões que melhoram sua experiência de codificação. Este guia passo a passo ajudará a configurar um projeto Python do zero usando o VS Code.

Requisitos

Antes de começarmos, certifique-se de ter os seguintes pré-requisitos instalados em seu computador:

• Python Runtime: Você precisa baixar e instalar o Python do site oficial do Python. Certifique-se de que a opção de instalação para adicionar o Python à variável PATH do seu sistema esteja ativada.
• VS Code: Disponível no site oficial do Visual Studio Code, o VS Code é um editor de código-fonte gratuito.
• Extensão Python para VS Code: Esta extensão fornece todo o suporte necessário para programação em Python, como Intellisense (autocompletar código), linting e depuração. Pode ser facilmente instalada no Marketplace de Extensões do VS Code.

Instalando o VS Code

Para começar, baixe o instalador do VS Code para seu sistema operacional no site oficial. Siga as instruções de instalação fornecidas, certificando-se de que todos os componentes necessários, especialmente os relacionados ao desenvolvimento, estejam selecionados. Após a instalação, abra o VS Code.

Configurando o ambiente Python

Instalando Python

Para instalar o Python, visite o site oficial do Python e baixe o instalador para seu sistema operacional. Execute o instalador e escolha as opções de configuração que melhor lhe convêm, certificando-se de adicionar o Python ao PATH do sistema se solicitado.

Instalando as Extensões Python no VS Code

Inicie o VS Code e abra a visualização de Extensões clicando no ícone de extensões na Barra de Atividades ao lado da janela ou usando o atalho Ctrl+Shift+X. Procure por "Python" no Marketplace de Extensões. Clique em Instalar para adicionar a extensão Python da Microsoft. Esta extensão adiciona funcionalidades essenciais específicas do Python ao editor, que são necessárias para desenvolver aplicações em Python.

Criando um novo projeto Python

Depois de configurar o Python e as extensões necessárias, o próximo passo é criar um novo projeto Python. Você pode fazer isso usando o VS Code com o seguinte método:

Abrindo um novo espaço de trabalho

Um espaço de trabalho no VS Code é um contêiner onde você pode gerenciar seus arquivos de projeto Python. Para começar, abra o VS Code e selecione “Abrir Pasta” no menu Arquivo. Crie uma nova pasta no diretório desejado onde você deseja armazenar seus arquivos do projeto Python. Após criar a pasta, selecione-a e abra-a no VS Code.

Criando um arquivo Python

Dentro da pasta do seu projeto, crie um novo arquivo Python. Você pode fazer isso clicando no ícone "Novo Arquivo" na visualização do Explorador (a barra lateral esquerda com as pastas/arquivos) ou usando o menu Arquivo e selecionando "Novo Arquivo". Dê a ele um nome descritivo, como main.py. Este será seu arquivo de script Python principal onde você escreverá seu código.

Escrevendo código Python

Python é uma linguagem interpretada, então você pode escrever e executar seu código imediatamente após criar seu arquivo Python.

Escrevendo um programa simples

Para começar, vamos criar um programa simples que imprime "Olá, Mundo!" no console. Isso pode ser feito escrevendo o seguinte código em seu arquivo main.py:

print("Olá, Mundo!")

Executando seu código Python

Para executar seu script Python, você tem várias opções. A maneira mais fácil é abrir o terminal diretamente no VS Code. Você pode abrir o terminal selecionando "Terminal" no menu superior e depois "Novo Terminal". No terminal, certifique-se de estar no diretório correto que contém seu arquivo main.py e execute o script digitando o comando:

python main.py

Se tudo estiver configurado corretamente, a saída deve ser assim:

Olá, Mundo!

Usando o Depurador do VS Code

Um dos recursos poderosos do VS Code é seu depurador embutido, que pode ser usado para identificar e corrigir problemas em seu código. Para usar o depurador, defina um ponto de interrupção em seu arquivo de script clicando na margem à esquerda dos números de linha. Isso criará um pequeno ponto vermelho indicando onde a execução do seu script será interrompida.

Configurando o depurador

Para começar a depuração, vá para o ícone de Depuração na Barra de Atividades e clique no ícone de engrenagem para abrir o arquivo de configuração launch.json. O VS Code sugerirá uma configuração padrão para projetos Python, que você pode ajustar conforme necessário.

Exemplo de configuração launch.json:

{ "version": "0.2.0", "configurations": [ { "name": "Python: Arquivo Atual", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal" } ] }

Iniciando uma sessão de depuração

Depois de definir os pontos de interrupção e verificar a configuração do depurador, inicie o depurador pressionando F5 ou clicando na opção "Iniciar Depuração" no menu de Depuração. Seu script Python será executado e interromperá a execução no ponto de interrupção, permitindo que você inspecione variáveis, percorra o código e identifique qualquer problema.

Gerenciando dependências do projeto Python

Gerenciar dependências é crucial para qualquer projeto Python, e pode ser gerenciado eficientemente usando ambientes virtuais.

Criação de ambientes virtuais

Na sua pasta de projeto, crie um ambiente virtual executando o seguinte comando no terminal:

python -m venv venv

Este comando criará um novo diretório chamado venv que conterá uma instalação independente do Python juntamente com outros scripts e executáveis. É uma boa prática organizar suas dependências separadamente dos pacotes globais instalados no seu sistema.

Ativando o ambiente virtual

Para ativar o ambiente virtual, execute:

• para Windows:

  .\venv\Scripts\activate

• Para MacOS/Linux:

  source venv/bin/activate

Uma vez ativado, o prompt do terminal deve refletir o ambiente ativo, geralmente prefixando a linha de comando com (venv).

Instalando pacotes usando o pip

Quando o ambiente virtual estiver ativado, você pode instalar pacotes usando o pip. Por exemplo, se seu projeto requer o pacote numpy, instale-o com o comando:

pip install numpy

Para salvar as dependências do seu ambiente atual em um arquivo requirements.txt que você pode enviar para seu repositório de controle de versão, use:

pip freeze > requirements.txt

Posteriormente, qualquer pessoa com acesso ao seu projeto pode instalar as dependências executando pip install -r requirements.txt.

Usando controle de versão com Git

O Git é uma ferramenta essencial para gerenciar versões de código e colaborar com outros. O VS Code possui suporte embutido ao Git que facilita o rastreamento de alterações e a colaboração em projetos.

Inicializando o Repositório Git

Para inicializar um repositório Git na sua pasta de projeto, abra o terminal no VS Code e digite:

git init

Este comando cria um novo repositório Git no diretório do seu projeto. Sua pasta de projeto agora contém um diretório .git, que é oculto por padrão.

Fazendo seu primeiro commit

Após inicializar o repositório, faça seu primeiro commit organizando quaisquer alterações e confirmando-as. Use estes comandos:

git add . 
git commit -m "Commit inicial"

O primeiro comando organiza todos os arquivos, e o segundo faz o commit com a mensagem "Commit inicial".

Usando a visualização de Controle de Fonte

O VS Code oferece uma interface intuitiva para operações do Git. Clique no ícone de Controle de Fonte na Barra de Atividades para visualizar uma lista de alterações, organizar alterações e fazer commits usando a interface do VS Code.

Resumo

O Visual Studio Code fornece um ambiente de desenvolvimento altamente integrado que suporta todo o ciclo de vida de um projeto Python, desde a escrita e execução do código até a depuração, gestão de dependências e controle de versão.

Este guia abrange a instalação do VS Code, configuração do Python, criação de um espaço de trabalho do projeto, escrita e execução de código, uso de ferramentas de depuração, gerenciamento de dependências com ambientes virtuais e integração com controle de versão do Git. Ao aproveitar eficazmente essas ferramentas, você pode simplificar o processo de desenvolvimento, teste e implantação de aplicações Python, aumentando a produtividade individual e colaborativa na programação.

  Compartilhe Este Artigo

Se você encontrar algo errado com o conteúdo do artigo, você pode solicitar uma atualização