Configura o teu ambiente de desenvolvimento Python no Windows

Existem várias razões para uma instalação falhar — em muitos casos, a solução correta é contactar o desenvolvedor do pacote.

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

Alguns pacotes incluem código nativo que requer um compilador C ou C++ para ser instalado. Em geral, os desenvolvedores de pacotes devem publicar versões pré-compiladas, mas muitas vezes não o fazem. Alguns destes pacotes podem funcionar se instalares Build Tools para Visual Studio e selecionares a opção C++, no entanto, na maioria dos casos terás de contactar o programador do pacote.

Siga a discussão no StackOverflow

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, poderá 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 estejas a usar um firewall aftermarket, 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

Podes acabar por ter várias versões de Python instaladas na tua máquina porque estás a trabalhar em diferentes tipos de projetos em Python. Como todos usam o comando python, pode não ser óbvio qual versão de Python está a usar. Como padrão, recomenda-se usar o python3 comando (ou python3.7 selecionar uma versão específica).

O launcher py.exe selecionará automaticamente a versão mais recente de Python que instalou. Também pode usar comandos como py -3.7 selecionar uma versão específica, ou py --list ver quais as versões que podem ser usadas. NO ENTANTO, o launcher de py.exe só funcionará se estiveres a usar uma versão do Python instalada a partir de python.org. Quando instalas Python do Microsoft Store, o comando py aparece not included. Para Linux, macOS, WSL e a versão Microsoft Store do Python, deve usar o comando python3 (ou python3.7).

Para ajudar os novos utilizadores a encontrar uma boa instalação de Python, adicionámos um atalho para o Windows que o levará diretamente à versão mais recente do pacote da comunidade publicada na Microsoft Store. Este pacote pode ser instalado facilmente, sem permissões de administrador, e substituirá os comandos predefinidos python e python3 pelos reais.

Executar o executável de atalho com quaisquer argumentos de linha de comandos retornará um código de erro para indicar que o Python não foi instalado. Isto serve para evitar que ficheiros e scripts em lote abram a aplicação da Store quando provavelmente não foi intencional.

Se instalares Python usando os instaladores do python.org e selecionares a opção "adicionar ao PATH", o novo comando python terá prioridade sobre o atalho. Esteja ciente de que outros instaladores podem adicionar python com prioridade inferior do que o atalho incorporado.

Podes desativar os atalhos sem instalar Python abrindo "Gerir alias de execução de aplicações" no Start, encontrando as entradas Python "App Installer" e mudando-as para "Desligado".

As strings do Python usam "escapes" para caracteres especiais. Por exemplo, para inserir um novo carácter de linha numa cadeia, deveria escrever \n. Como os caminhos dos ficheiros no Windows usam barras invertidas, algumas partes podem ser convertidas em caracteres especiais.

Para colar um caminho como cadeia em Python, adicione o prefixo r. Isto indica que é uma raw cadeia, e não serão usados caracteres de escape exceto " (pode ser necessário remover a última barra diagonal no seu caminho). Portanto, o seu percurso pode ser: r"C:\Users\MyName\Documents\Document.txt"

Ao trabalhar com caminhos em Python, recomendamos usar o módulo padrão de pathlib. Isto permite-te converter a string para um objeto Path avançado que pode realizar manipulações de caminho de forma consistente, quer use barras normais ou invertidas, assegurando que o teu código funcione melhor em diferentes sistemas operativos.

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

Para definir esta variável a partir do Prompt de Comandos, use: set PYTHONPATH=list;of;paths.

Para definir esta variável a partir do PowerShell, use: $env:PYTHONPATH='list;of;paths' pouco antes de lançar Python.

Definir esta variável globalmente através das definições de Variáveis de Ambiente não é recomendado, pois pode ser usada por qualquer versão do Python em vez da que pretende usar.

Docker: A extensão VSCode ajuda-te a empacotar e implementar rapidamente com Dockerfile e docker-compose.yml templates (gerar os ficheiros Docker adequados para o teu projeto).

Azure Kubernetes Service (AKS) permite-lhe implementar e gerir aplicações containerizadas enquanto escala recursos sob demanda.

O VS Code tem o Settings Sync incorporado que te permite partilhar as tuas definições, atalhos de teclas, extensões e muito mais entre máquinas usando o teu GitHub ou conta Microsoft. Não é necessária extensão.

A extensão Keymaps do VSCode pode ajudar o seu ambiente a sentir-se em casa.

Alguns dos botões do teclado e atalhos do sistema são ligeiramente diferentes entre uma máquina Windows e um Macintosh. Este guia de transição Mac para Windows cobre o básico.

• Edição de Python no VS Code: Saiba mais sobre como tirar partido do autocompletar do VS Code e do suporte IntelliSense para Python, incluindo como personalizar o seu comportamento... Ou simplesmente desativá-los.
• Linting Python: Linting é o processo de executar um programa que analisa código em busca de potenciais erros. Aprenda sobre as diferentes formas de suporte para linting que o VS Code oferece para Python e como o configurar.
• Depuração 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 VS Code, como definir e validar pontos de interrupção, anexar um script local, realizar depuração para diferentes tipos de aplicações ou num computador remoto, e algumas soluções básicas de resolução de problemas.
• Testes unitários Python: Cobre algum contexto explicando o significado dos testes unitários, um exemplo de walkthrough, ativação de um framework de testes, criação e execução dos seus testes, depuração de testes e definições de configuração de testes.