Compartilhar via

Configurar seu ambiente de desenvolvimento do Python no Windows

Prepare seu ambiente python no Windows em minutos – configure-o manualmente ou automatize tudo com winget. Você precisará do seguinte:

  • Python 3.13 – O runtime mais recente do Python
  • Visual Studio Code – Um editor de código leve e poderoso
  • Extensão do Python para Visual Studio Code – adiciona suporte à linguagem Python, depuração, linting e muito mais

O arquivo de configuração do WinGet abaixo instala automaticamente tudo listado acima.

Para começar:

  1. Abra o PowerShell no Terminal do Windows e execute o seguinte comando:

    winget configure -f https://aka.ms/python-config

  2. Quando a configuração é iniciada, uma janela do terminal mostra as etapas de instalação e as instalações necessárias. Examine-os e confirme selecionando [Y] Sim ou [N] Não para continuar.

  3. As cargas de trabalho necessárias foram instaladas. Verifique sua configuração executando python --version.

Agora você está pronto para o desenvolvimento do Python.

Introdução ao Python

Perguntas frequentes

Problemas para instalar um pacote com a instalação do pip

Há vários motivos pelos quais uma instalação falhará, em muitos casos, a solução certa é entrar em contato com o desenvolvedor do pacote.

Uma causa comum para problemas é tentar instalar em um local que você não tem permissão para modificar. Por exemplo, o local de instalação padrão pode exigir privilégios administrativos, mas por padrão o Python não os terá. A melhor solução é criar um ambiente virtual e instalar lá.

Alguns pacotes incluem código nativo que requer que um compilador C ou C++ seja instalado. Em geral, os desenvolvedores de pacotes devem publicar versões pré-compiladas, mas muitas vezes não o fazem. Alguns desses pacotes poderão funcionar se você instalar o Build Tools para Visual Studio e selecionar a opção C++, no entanto, na maioria dos casos, você precisará entrar em contato com o desenvolvedor do pacote.

Siga a discussão sobre StackOverflow

Problemas para instalar o pip com o WSL

Ao instalar um pacote (como o Flask) com pip no Subsistema do Windows para Linux (WSL ou WSL2), por exemplo python3 -m pip install flask, você pode encontrar um erro como este:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

A menos que você esteja executando um firewall de pós-venda, a solução provável é simplesmente reinstalar o pip:

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
O que é py.exe?

Você pode acabar com várias versões do Python instaladas em seu computador porque está trabalhando em diferentes tipos de projetos do Python. Como todos eles usam o python comando, pode não ser óbvio qual versão do Python você está usando. Como padrão, é recomendável usar o python3 comando (ou python3.7 selecionar uma versão específica).

O inicializadorpy.exe selecionará automaticamente a versão mais recente do Python que você instalou. Você também pode usar comandos como py -3.7 selecionar uma versão específica ou py --list ver quais versões podem ser usadas. No entanto, o inicializador de py.exe só funcionará se você estiver usando uma versão do Python instalada do python.org. Quando você instala o Python da Microsoft Store, o py comando não é incluído. Para Linux, macOS, WSL e a versão da Microsoft Store do Python, você deve usar o python3 comando (ou python3.7) .

Por que ao executar python.exe a Microsoft Store é aberta?

Para ajudar novos usuários a encontrar uma boa instalação do Python, adicionamos um atalho ao Windows que levará você diretamente à versão mais recente do pacote da comunidade publicado na Microsoft Store. Esse pacote pode ser instalado facilmente, sem permissões de administrador, e substituirá os comandos padrão python e python3 pelos comandos reais.

Executar o executável de atalho com argumentos de linha de comando retornará um código de erro para indicar que o Python não foi instalado. Isso é para impedir que arquivos em lote e scripts abram o aplicativo Store quando provavelmente não era essa a intenção.

Se você instalar o Python usando os instaladores de python.org e selecionar a opção "adicionar ao PATH", o novo python comando terá prioridade sobre o atalho. Observe que outros instaladores podem adicionar python a uma prioridade menor do que o atalho embutido.

Você pode desabilitar os atalhos sem instalar o Python abrindo "Gerenciar aliases de execução de aplicativo" no Iniciar, encontrando as entradas do Python no "Instalador de Aplicativo" e mudando-as para "Desativado".

Por que os caminhos de arquivo não funcionam no Python quando os copiei?

As cadeias de caracteres do Python usam "escapes" para caracteres especiais. Por exemplo, para inserir um novo caractere de linha em uma cadeia de caracteres, você digitaria \n. Como os caminhos de arquivo no Windows usam contrabarra, algumas partes podem estar sendo convertidas em caracteres especiais.

Para colar um caminho como uma cadeia de caracteres no Python, adicione o r prefixo. Isso indica que é uma raw string, e nenhum caractere de escape será usado, exceto " (talvez seja necessário remover a última barra invertida, ou backslash, em seu caminho). Portanto, seu caminho pode ser semelhante a: r"C:\Users\MyName\Documents\Document.txt"

Ao trabalhar com caminhos no Python, é recomendável usar o módulo pathlib padrão. Isso permitirá que você converta a string em um objeto de Caminho rico que pode realizar manipulações de caminho de forma consistente, independentemente de usar barras normais ou invertidas, fazendo com que seu código funcione melhor em diferentes sistemas operacionais.

O que é PYTHONPATH?

A variável de ambiente PYTHONPATH é usada pelo Python para especificar uma lista de diretórios dos quais os módulos podem ser importados. Ao executar, você pode inspecionar a sys.path variável para ver quais diretórios serão pesquisados quando você importar algo.

Para definir essa variável do Prompt de Comando, use: set PYTHONPATH=list;of;paths.

Para definir essa variável do PowerShell, use: $env:PYTHONPATH='list;of;paths' pouco antes de iniciar o Python.

Não é recomendável definir essa variável globalmente por meio das configurações de Variáveis de Ambiente, pois ela pode ser usada por qualquer versão do Python em vez daquela que você pretende usar.

Onde posso encontrar ajuda com empacotamento e implantação?

Docker: a extensão VSCode ajuda você a empacotar e implantar rapidamente com o Dockerfile e docker-compose.yml modelos (gerar os arquivos do Docker adequados para seu projeto).

O AKS (Serviço de Kubernetes do Azure) permite implantar e gerenciar aplicativos em contêineres enquanto dimensiona recursos sob demanda.

E se eu precisar trabalhar em máquinas diferentes?

A Sincronização de Configurações permite que você sincronize as configurações do VS Code em diferentes instalações usando o GitHub. Se você trabalha em computadores diferentes, isso ajuda a manter seu ambiente consistente entre eles.

E se eu estiver acostumado a usar PyCharm, Atom, Sublime Text, Emacs ou Vim?

A extensão de Keymaps do VSCode pode ajudar seu ambiente a parecer familiar.

Como as teclas de atalho do Mac são mapeadas para as teclas de atalho do Windows?

Alguns dos botões de teclado e atalhos do sistema são ligeiramente diferentes entre um computador Windows e um Macintosh. Este guia de transição do Mac para o Windows aborda as noções básicas.

Onde posso saber mais sobre como usar o Python no VS Code?
  • Editando o Python no VS Code: saiba mais sobre como aproveitar o preenchimento automático do VS Code e o suporte do IntelliSense para Python, incluindo como personalizar seu comportamento... ou simplesmente desative-os.
  • Linting Python: Linting é o processo de execução de um programa que analisará o código para possíveis erros. Saiba mais sobre as diferentes formas de suporte de linting que o VS Code fornece para Python e como configurá-lo.
  • Depuração do Python: a depuração é o processo de identificar e remover erros de um programa de computador. Este artigo aborda como inicializar e configurar a depuração para Python com o VS Code, como definir e validar pontos de interrupção, anexar um script local, executar a depuração para diferentes tipos de aplicativo ou em um computador remoto e alguma solução de problemas básica.
  • Teste de unidade do Python: abrange alguns fundamentos explicando o que significa teste de unidade, um passo a passo de exemplo, habilitar um framework de teste, criar e executar seus testes, depurar testes e configurações de teste.
  • Last updated on