Partilhar via

Configura o teu ambiente de desenvolvimento Python no Windows

Prepara o teu ambiente Python no Windows em minutos — configura-o manualmente ou automatiza tudo com o winget. Vai precisar do seguinte:

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

O ficheiro de configuração do WinGet abaixo instala tudo o que foi listado acima automaticamente.

Para começar:

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

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

  2. Quando a configuração começa, uma janela de terminal mostra os passos de configuração e as instalações necessárias. Revê-as e depois confirma selecionando [Y] Sim ou [N] Não para continuar.

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

Agora estás pronto para o desenvolvimento em Python.

Introdução ao Python

Perguntas Mais Frequentes

Problemas ao instalar um pacote com pip install

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 por defeito 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 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 instalar o Build Tools para Visual Studio e selecionar a opção C++, no entanto, na maioria dos casos, terá de contactar o programador do pacote.

Siga a discussão no StackOverflow

Problemas na instalação do pip com WSL

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

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
O que é py.exe?

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 python comando, pode não ser óbvio qual a versão do Python que estás a usar. Como padrão, recomenda-se usar o python3 comando (ou python3.7 selecionar uma versão específica).

O lançadorpy.exe selecionará automaticamente a versão mais recente de Python que instalaste. 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 py.exe só funciona se estiveres a usar uma versão de Python instalada a partir de python.org. Quando instalas Python a partir da Microsoft Store, o py comando não está incluído. Para Linux, macOS, WSL e a versão Microsoft Store de Python, deve usar o python3 comando (ou python3.7).

Porque é que correr python.exe abre a Microsoft Store?

Para ajudar novos utilizadores a encontrar uma boa instalação de Python, adicionámos um atalho ao Windows que o levará diretamente à versão mais recente do pacote da comunidade publicado 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 da python.org e selecionares a opção "adicionar ao PATH", o novo python comando terá prioridade sobre o atalho. Esteja ciente de que outros instaladores podem adicionar python com prioridade inferior do que o atalho incorporado.

Pode desativar os atalhos sem instalar Python abrindo "Gerir alias de execução de aplicações" a partir de Iniciar, encontrando as entradas em Python do "App Installer" e mudando-as para "Desligado".

Porque é que os caminhos dos ficheiros não funcionam em Python quando os copio-colo?

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

Para colar um caminho como string em Python, adicione o r prefixo. 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 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.

O que é o PYTHONPATH?

A variável de ambiente PYTHONPATH é usada pelo Python para especificar uma lista de diretórios dos quais 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 no PowerShell, use: $env:PYTHONPATH='list;of;paths' pouco antes de lançar o Python.

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

Onde posso encontrar ajuda com a embalagem e implementação?

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).

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

E se precisar de trabalhar em diferentes máquinas?

O Settings Sync permite-te sincronizar as definições do VS Code entre diferentes instalações usando o GitHub. Se trabalhares em máquinas diferentes, isso ajuda a manter o ambiente consistente entre elas.

E se já estiver habituado a usar PyCharm, Atom, Sublime Text, Emacs ou Vim?

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

Como é que as teclas de atalho do Mac se mapeiam para as teclas de atalho do Windows?

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 de Mac para Windows cobre o básico.

Onde posso aprender mais sobre o uso de Python no VS Code?
  • Editar Python no VS Code: Saiba mais sobre como tirar partido do autopreenchimento do VS Code e do suporte IntelliSense para Python, incluindo como personalizar o seu comportamento... Ou simplesmente desliga-os.
  • 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 de Python: Depuração é o processo de identificar e remover erros de um programa de computador. Este artigo aborda como inicializar e configurar 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 diagnóstico.
  • Testes unitários em Python: Cobre algum contexto explicando o que significa teste unitário, um exemplo de guia, 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.
  • Last updated on