Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Prepare seu ambiente de Python em Windows em minutos – instale na linha de comando com winget ou configure-o manualmente. Você precisará do seguinte:
- Python – o runtime de Python estável atual (3.14 ou posterior)
- Visual Studio Code – um editor de código leve e poderoso
- extensão Python para Visual Studio Code – adiciona suporte à linguagem Python, depuração, análise de código e muito mais
Abra o PowerShell no Terminal do Windows e instale Python:
winget install Python.Python.3.14Instalar Visual Studio Code:
winget install Microsoft.VisualStudioCodeFeche e reabra o PowerShell e verifique se Python está instalado:
python --versionAbra o VS Code e instale a extensão Python do VS Code Marketplace.
Agora você está pronto para desenvolvimento em 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 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 ferramentas de build 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.
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?
Por que executar python.exe abre a Microsoft Store?Você pode acabar com várias versões de Python instaladas em seu computador porque você está trabalhando em diferentes tipos de projetos de Python. Como todos eles usam o comando
python, talvez não seja óbvio qual versão do Python você está usando. Como padrão, é recomendável usar opython3comando (oupython3.7selecionar uma versão específica).O inicializador py.exe selecionará automaticamente a versão mais recente do Python instalado. Você também pode usar comandos como
py -3.7selecionar uma versão específica oupy --listver quais versões podem ser usadas. HOWEVER, o inicializador de py.exe só funcionará se você estiver usando uma versão de Python instalada do python.org. Quando você instala Python do Microsoft Store, o comandopyé não incluído. Para Linux, macOS, WSL e a versão Microsoft Store do Python, você deve usar o comandopython3(oupython3.7).
Para ajudar novos usuários a encontrar uma boa instalação de Python, adicionamos um atalho para Windows que o levará diretamente à versão mais recente do pacote da comunidade publicado no Microsoft Store. Esse pacote pode ser instalado facilmente, sem permissões de administrador, e substituirá os comandos padrão
pythonepython3pelos comandos reais.Executar o executável de atalho com argumentos de linha de comando retornará um código de erro para indicar que 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 Python usando os instaladores do python.org e selecionar a opção "adicionar ao PATH", o novo comando
pythonterá prioridade sobre o atalho. Observe que outros instaladores podem adicionarpythona uma prioridade menor do que o atalho embutido.Você pode desabilitar os atalhos sem instalar o Python abrindo "Gerenciar aliases de execução do aplicativo" no Menu Iniciar, encontrando as entradas de Python no "App Installer" e alternando-as para "Desativado".
Por que os caminhos de arquivo não funcionam em Python quando os copiei?
Python strings usam "sequências de escape" 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 barras invertidas, algumas partes podem estar sendo convertidas em caracteres especiais.Para colar um caminho como uma cadeia de caracteres em Python, adicione o prefixo
r. Isso indica que é umarawstring, 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 em Python, recomendamos 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 por Python para especificar uma lista de diretórios dos quais os módulos podem ser importados. Ao executar, você pode inspecionar a
sys.pathvariá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 Python.Definir essa variável globalmente por meio das configurações Environment Variables é not recomendado, pois ela pode ser usada por qualquer versão do Python em vez da 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).
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?
O VS Code possui um recurso de Settings Sync que permite compartilhar suas configurações, atalhos de teclado, extensões e muito mais em computadores usando sua conta do GitHub ou da Microsoft. Nenhuma extensão é necessária.
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 correspondem às 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 Mac para Windows guia de transição abrange as noções básicas.
Em lugares onde posso saber mais sobre como usar Python no VS Code?
- Editing 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.
- Debugging 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.
- Unit testing Python: aborda algum contexto explicando o que significa teste de unidade, um passo a passo de exemplo, habilitação de uma estrutura de teste, criação e execução de testes, depuração de testes e configurações de testes.
Windows developer