Referência das guias da janela de Ambientes Python em Ferramentas Python para Visual Studio

Para abrir a janela Python Environments:

• Selecione o comando de menu Exibir>Outros Ambientes Windows>Python.
• Clique com o botão direito do mouse no nó Ambientes Python para um projeto no Explorador de Soluções e selecione Ver todos os ambientes Python.

Se você expandir a janela Python Environments suficientemente ampla, essas opções serão mostradas como guias, com as quais você pode achar mais conveniente trabalhar. Para maior clareza, as guias neste artigo são mostradas no modo de exibição expandido.

de visualização expandida da janela Ambientes Python

Aba: Visão geral

Fornece informações básicas e comandos para o ambiente:

Comando	Descrição
Tornar esse ambiente o padrão para novos projetos	Define o ambiente ativo, o que pode fazer com que o Visual Studio (versão 15.5 e anterior de 2017) pare brevemente de responder enquanto carrega o banco de dados IntelliSense. Ambientes com muitos pacotes podem não responder por um período de tempo prolongado.
Visite o site do distribuidor	Abre um navegador para a URL fornecida pela distribuição Python. Python 3.x, por exemplo, vai para python.org.
Abrir janela interativa	Abre a janela interativa (REPL) para este ambiente no Visual Studio, aplicando quaisquer scripts de inicialização (veja abaixo).
Explore scripts interativos	Consulte os scripts de inicialização.
Use o modo interativo IPython	Quando configurado, abre a janela interativa com IPython por predefinição. Isso permite gráficos inline, bem como a sintaxe estendida do IPython, como name? para visualizar ajuda e !command para comandos de terminal. Esta opção é recomendada ao usar uma distribuição Anaconda, pois requer pacotes extras. Para obter mais informações, consulte Usar IPython na janela Interativa.
Abrir no PowerShell	Inicia o interpretador em uma janela de comando do PowerShell.
Ligações de pastas e programas	Forneça acesso rápido à pasta de instalação do ambiente, ao interpretador de python.exe e ao intérprete de pythonw.exe. O primeiro abre no Windows Explorer, os dois últimos abrem uma janela do console.

Scripts de inicialização

À medida que utiliza janelas interativas no seu fluxo de trabalho diário, é provável que desenvolva funções auxiliares que utiliza regularmente. Por exemplo, você pode criar uma função que abre um DataFrame no Excel e, em seguida, salvar esse código como um script de inicialização para que ele esteja sempre disponível na janela Interactive.

Os scripts de inicialização contêm código que a janela Interactive carrega e executa automaticamente, incluindo importações, definições de função e literalmente qualquer outra coisa. Esses scripts são referenciados de duas maneiras:

1. Quando você instala um ambiente, o Visual Studio cria uma pasta Documents\Visual Studio <versão>\Python Scripts\<ambiente> onde <versão> é a versão do Visual Studio (como 2017 ou 2019) e <ambiente> corresponde ao nome do ambiente. Você pode navegar facilmente para a pasta específica do ambiente com o comando explorar scripts interativos. Quando você inicia a janela interativo para esse ambiente, ela carrega e executa todos os arquivos .py encontrados aqui em ordem alfabética.

2. O controlo de Scripts na aba Ferramentas>Opções>Python>Windows Interativos (consulte Opções de janelas interativas) destina-se a especificar uma pasta adicional para scripts de inicialização que são carregados e executados em todos os ambientes. No entanto, esse recurso não funciona no momento.

Guia Configurar

Se disponível, a guia Configurar contém detalhes conforme descrito na tabela abaixo. Se essa guia não estiver presente, isso significa que o Visual Studio está gerenciando todos os detalhes automaticamente.

Campo	Descrição
Descrição	O nome a dar ao ambiente.
Caminho do prefixo	O local da pasta base do intérprete. Ao preencher este valor e clicar em Deteção Automática, o Visual Studio tenta preencher os outros campos para si.
Caminho do intérprete	O caminho para o executável do interpretador, geralmente o caminho do prefixo seguido por python.exe
Intérprete com janelas	O caminho para o executável sem console, geralmente o caminho de prefixo seguido por pythonw.exe.
Caminho da biblioteca (se disponível)	Especifica a raiz da biblioteca padrão, mas esse valor pode ser ignorado se o Visual Studio for capaz de solicitar um caminho mais preciso do interpretador.
Versão linguística	Selecionado a partir do menu suspenso.
Arquitetura	Normalmente detetado e preenchido automaticamente, caso contrário, especifica de 32 bits ou de 64 bits.
Variável de ambiente Path	A variável de ambiente que o intérprete usa para encontrar caminhos de pesquisa. O Visual Studio altera o valor da variável ao iniciar o Python para que ele contenha os caminhos de pesquisa do projeto. Normalmente, essa propriedade deve ser definida como PYTHONPATH, mas alguns interpretadores usam um valor diferente.

Guia Pacotes

Também rotulado como "pip" em versões anteriores.

Gere os pacotes que estão instalados no ambiente usando pip (a guia Pacotes (PyPI) ) ou conda (a guia Pacotes (Conda) , para ambientes conda no Visual Studio 2017 na versão 15.7 ou posterior). Nesta guia, você também pode procurar e instalar novos pacotes, incluindo suas dependências.

Os pacotes que já estão instalados aparecem com controles para atualizar (uma seta para cima) e desinstalar (o X em um círculo) o pacote:

Inserir um termo de pesquisa filtra a lista de pacotes instalados, bem como os pacotes que podem ser instalados a partir do PyPI.

Como pode ver na imagem acima, os resultados de pesquisa mostram vários pacotes que correspondem ao termo de pesquisa; a primeira entrada na lista, no entanto, é um comando para executar pip install <nome> diretamente. Se estiver na guia Pacotes (Conda), verá conda install <name>:

Em ambos os casos, você pode personalizar a instalação adicionando argumentos na caixa de pesquisa após o nome do pacote. Quando você inclui argumentos, os resultados da pesquisa mostram pip install ou conda install seguido pelo conteúdo da caixa de pesquisa:

A instalação de um pacote cria subpastas dentro da pasta Lib do ambiente no sistema de arquivos. Por exemplo, se você tiver o Python 3.6 instalado no c:\Python36, os pacotes serão instalados no c:\Python36\Lib; se você tiver Anaconda3 instalado no c:\Program Files\Anaconda3 então os pacotes são instalados no c:\Program Files\Anaconda3\Lib. Para ambientes conda, os pacotes são instalados na pasta desse ambiente.

Conceder privilégios de administrador para instalação de pacotes

Ao instalar pacotes em um ambiente localizado em uma área protegida do sistema de arquivos, como c:\Program Files\Anaconda3\Lib, o Visual Studio deve executar pip install elevado para permitir que ele crie subpastas de pacote. Quando a elevação é necessária, o Visual Studio exibe o prompt privilégios de administrador podem ser necessários para instalar, atualizar ou remover pacotes para este ambiente:

Elevate agora concede privilégios administrativos ao pip para uma única operação, sujeito também a quaisquer solicitações de permissões do sistema operacional. Selecionar Continuar sem privilégios de administrador tenta instalar o pacote, mas pip falha ao tentar criar pastas com saída, como erro: não foi possível criar 'C:\Program Files\Anaconda3\Lib\site-packages\png.py': Permissão negada.

Selecionar a opção "Sempre elevar ao instalar ou remover pacotes" impede que a caixa de diálogo apareça para o ambiente em questão. Para fazer com que a caixa de diálogo apareça novamente, vá para Ferramentas Opções>>Python>General e selecione o botão Redefinir todas as caixas de diálogo permanentemente ocultas.

Nesse mesmo separador Opções, pode também selecionar Sempre executar o pip como administrador para suprimir a caixa de diálogo para todos os ambientes. Para obter mais informações, consulte Opções - guia Geral do Python.

Restrições de segurança com versões mais antigas do Python

Ao usar Python 2.6, 3.1 e 3.2, o Visual Studio mostra o aviso, Devido a novas restrições de segurança, a instalação a partir da Internet pode não funcionar nesta versão do Python:

A razão para o aviso é que, com essas versões mais antigas do Python, pip install não contém suporte para o Transport Security Layer (TLS) 1.2, que é necessário para baixar pacotes da fonte do pacote, pypi.org. Compilações Python personalizadas podem suportar TLS 1.2, caso em que pip install pode funcionar.

Pode ser possível baixar o get-pip.py apropriado para um pacote do bootstrap.pypa.io, baixar manualmente um pacote do pypi.orge, em seguida, instalar o pacote a partir dessa cópia local.

A recomendação, no entanto, é simplesmente atualizar para uma versão recente do Python, caso em que o aviso não aparece.

Ver também

• Gerir ambientes Python no Visual Studio
• Selecione um intérprete para um projeto
• Usar requirements.txt para dependências
• Caminhos de pesquisa