Problemas ao instalar um pacote usando a instalação PIP
Uma falha poderá ocorrer na instalação por vários motivos. Em muitos casos, a solução mais adequada será entrar em contato com o desenvolvedor do pacote.
Uma causa comum de problemas é tentar executar a instalação em um local em que você não tem a permissão necessária para fazer modificações. Por exemplo, o local de instalação padrão pode exigir privilégios de administrador, mas, por padrão, o Python não tem esses privilégios. A solução mais adequada é criar um ambiente virtual, depois executar a instalação nele.
Alguns pacotes incluem código nativo que exige um compilador C ou C++ para instalação. Em geral, os desenvolvedores de pacotes costumam publicar versões pré-compiladas. Porém, algumas vezes eles não o fazem. Alguns desses pacotes poderão funcionar se você instalar Ferramentas de Build para o Visual Studio e selecionar a opção C++. No entanto, na maioria dos casos, será necessário entrar em contato com o desenvolvedor do pacote.
Problemas ao instalar o PIP usando o WSL
Ao instalar um pacote (como o Flask) usando o PIP no WSL ou no WSL2 (Subsistema do Windows para Linux), por exemplo python3 -m pip install flask, será possível encontrar, de modo específico, 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/
Ao pesquisar sobre esse problema, talvez você encontre informações inadequadas, além de pouco produtivas para a distribuição de WSL do Linux. (Aviso: não tente editar o resolv.conf no WSL, pois esse arquivo é um link simbólico e modificá-lo poderá gerar vários problemas). A menos que você esteja executando um firewall do aftermarket, a solução mais 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
*Mais discussões estão disponíveis no repositório do produto WSL do GitHub. Agradecemos à nossa comunidade de usuários por contribuir para solucionar esse problema de documentação.
O que é py.exe?
Você pode acabar com várias versões do Python instaladas em seu computador, já que está trabalhando em diferentes tipos de projetos do Python. Como todas usam o comando python, talvez não seja tão óbvio qual versão do Python você está usando. Como padrão, é recomendável usar o comando python3 (ou python3.7 para selecionar uma versão específica).
O inicializador py.exe selecionará automaticamente a versão mais recente do Python que você instalou. Você também pode usar comandos como py -3.7 para selecionar uma versão específica ou py --list para ver quais versões podem ser usadas. NO ENTANTO, o inicializador py.exe só funcionará se você estiver usando uma versão do Python instalada de python.org. Quando você instala o Python da Microsoft Store, o comando pynão está incluído. Para Linux, macOS, WSL e a versão Microsoft Store do Python você deve usar o comando python3 (ou python3.7).
Por que executar o python.exe abre a Microsoft Store?
Para ajudar novos usuários a encontrar uma boa instalação do Python, adicionamos um atalho para o Windows que o levará diretamente para a versão mais recente do pacote da comunidade publicado no Microsoft Store. Esse pacote pode ser instalado com facilidade – sem permissões de administrador – e substituirá os comandos padrão python e python3 pelos verdadeiros.
A execução do atalho executável com qualquer argumento 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 lotes e scripts abram o aplicativo do Microsoft Store quando provavelmente não foi pretendido.
Se você instalar o Python usando os instaladores de python.org e selecionar a opção "adicionar ao CAMINHO", o novo comando python terá prioridade sobre o atalho. Observe que outros instaladores podem adicionar python a uma prioridade mais baixa do que o atalho interno.
Você pode desabilitar os atalhos sem instalar o Python abrindo "Gerenciar aliases de execução de aplicativo", no menu Iniciar, localizando as entradas do Python do "Instalador de aplicativo" e alternando-as para "Desativado".
Por que os caminhos de arquivo não funcionam no Python quando eu os copio e colo?
As strings do python usam "escapes" para caracteres especiais. Por exemplo, para inserir um caractere de nova linha em uma cadeia de caracteres, você deve digitar \n. Como os caminhos de arquivo no Windows usam barras invertidas, algumas partes podem estar sendo convertidas em caracteres especiais.
Para colar um caminho como uma cadeia de caracteres no Python, adicione o prefixo r. Isso indica que se trata de uma cadeia de caracteres raw e nenhum caractere de escape será usado, exceto a \" (talvez seja necessário remover a última barra invertida do caminho). Portanto, seu caminho pode ter a seguinte aparência: 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 cadeia de caracteres em um objeto de caminho avançado, que pode fazer manipulações de caminho de forma consistente, independentemente de usar barras normais ou invertidas, fazendo com que o seu código funcione melhor em diferentes sistemas operacionais.
O que é o 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. Durante a execução, você poderá inspecionar a variável sys.path para ver quais diretórios serão pesquisados quando você importar algo.
Para definir essa variável no prompt de comando, use: set PYTHONPATH=list;of;paths.
Para definir essa variável no PowerShell, use: $env:PYTHONPATH=’list;of;paths’ logo antes de inicializar o Python.
Definir essa variável globalmente por meio das configurações de Variáveis de ambientenão é recomendável, pois ela pode ser usada por qualquer versão do Python em vez daquela que você pretende usar.
Onde posso encontrar ajuda com o empacotamento e a implantação?
Docker: A extensão VSCode ajuda você a empacotar e implantar rapidamente com os modelos Dockerfile e docker-compose.yml (gerar os arquivos de Docker apropriados para o seu projeto).
O AKS (Serviço de Kubernetes do Azure) permite implantar e gerenciar aplicativos em contêineres ao mesmo tempo em que dimensiona recursos sob demanda.
E se eu precisar trabalhar em diferentes computadores?
As Configurações de sincronização permitem que você sincronize suas configurações de VS Code em diferentes instalações usando o GitHub. Se você trabalha em diferentes computadores, 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 VSCode keymaps pode ajudar seu ambiente a se sentir em casa.
Qual é a correspondência entre as teclas de atalho do Mac e as teclas de atalho do Windows?
Alguns botões do teclado e atalhos do sistema são um pouco diferentes entre um computador Windows e um Macintosh. Este Guia de transição do Mac para o Windows aborda os conceitos básicos.
