Referência de guias da janela Ambientes do Python nas Ferramentas Python para Visual Studio

Para abrir a janela Ambientes de Python:

• Selecione o comando de menu Exibir>Outras Janelas>Ambientes do Python.
• Clique com o botão direito do mouse no nó Ambientes do Python de um projeto no Gerenciador de Soluções e escolha Exibir Todos os Ambientes do Python.

Se você expandir a janela Ambientes do Python até um tamanho grande o suficiente, essas opções serão mostradas como guias, o que talvez você considere mais conveniente para trabalhar. Para maior clareza, as guias neste artigo são mostradas na exibição expandida.

Guia: visão geral

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

Comando	Descrição
Tornar este ambiente padrão para novos projetos	Definir o ambiente ativo, o que pode fazer com que o Visual Studio (2017 versão 15.5 e anteriores) pare de responder brevemente enquanto carrega o banco de dados do IntelliSense. Ambientes com muitos pacotes podem parar de responder por um período maior.
Visitar o site do distribuidor	Abre um navegador para a URL fornecida para a distribuição de Python. Python 3. x, por exemplo, vai para python.org.
Abrir a janela interativa	Abre a janela interativa (REPL) para esse ambiente dentro do Visual Studio, aplicando quaisquer scripts de inicialização (veja abaixo).
Explorar scripts interativos	Veja os scripts de inicialização.
Usar o modo interativo do IPython	Quando definido, abre a janela Interativa com IPython por padrão. Isso habilita os gráficos embutidos e a sintaxe estendida do IPython como name? para exibir a ajuda e !command para comandos shell. Essa opção é recomendada quando estiver usando uma distribuição Anaconda, pois ela requer pacotes extras. Para obter mais informações, confira Usar o IPython na Janela Interativa.
Abrir no PowerShell	Inicia o interpretador em uma janela de comando do PowerShell.
(Links de pasta e do programa)	Os interpretadores python.exe e pythonw.exe fornecem acesso rápido à pasta de instalação do ambiente. O primeiro abre no Windows Explorer, os dois últimos abrem uma janela do console.

Scripts de inicialização

Como você janelas interativas no fluxo de trabalho diário, provavelmente desenvolverá funções auxiliares que você usa regularmente. Por exemplo, você pode criar uma função que abre um DataFrame no Excel e, em seguida, salva esse código como um script de inicialização para que ele esteja sempre disponível na janela Interativa.

Os scripts de inicialização contêm o código que a janela Interativa 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>, em que <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 Interativa para esse ambiente, ela carrega e executa qualquer arquivo .py que for encontrado aqui em ordem alfabética.

2. O controle Scripts na guia Ferramentas>Opções>Python>Janelas Interativas (confira Opções de janelas Interativas) destina-se a especificar uma pasta adicional para os scripts de inicialização que estão carregados e são executados em todos os ambientes. No entanto, esse recurso não funciona no momento.

Guia Configurar

Se estiver disponível, a guia Configurar conterá 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 ser fornecido para o ambiente.
Caminho do prefixo	A localização da pasta base do interpretador. Ao preencher esse valor e clicar em Detecção Automática, o Visual Studio tenta preencher os outros campos para você.
Caminho do interpretador	O caminho para o executável do interpretador, normalmente, o caminho do prefixo seguido por python.exe
Interpretador em janelas	O caminho para o executável que não é de console, geralmente, é o caminho do prefixo seguido por pythonw.exe.
Caminho da biblioteca (se estiver disponível)	Especifica a raiz da biblioteca padrão, mas esse valor poderá ser ignorado se o Visual Studio conseguir solicitar um caminho mais preciso do interpretador.
Versão da linguagem	Selecionada no menu suspenso.
Arquitetura	Normalmente, detectada e preenchida automaticamente. Caso contrário, especifica 32 bits ou 64 bits.
Variável de ambiente do caminho	A variável de ambiente que o interpretador usa para encontrar caminhos de pesquisa. O Visual Studio altera o valor da variável ao iniciar o Python, para que ela contenha os caminhos de pesquisa do projeto. Normalmente, essa propriedade deve ser definida como PYTHONPATH, mas alguns interpretadores usam outro valor.

Guia Pacotes

Também chamada de "pip" em versões anteriores.

Gerencia os pacotes instalados no ambiente usando pip (a guia Pacotes (PyPI)) ou o conda (a guia Pacotes (Conda), para ambientes do conda no Visual Studio 2017 versão 15.7 e posteriores). Nessa guia, você também pode procurar e instalar novos pacotes, incluindo as dependências dele.

Os pacotes que já estão instalados são exibidos com controles para atualizar (uma seta para cima) e desinstalar (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 do PyPI.

Como você pode ver na imagem acima, os resultados da pesquisa mostram vários pacotes que correspondem ao termo da pesquisa. A primeira entrada na lista, no entanto, é um comando para executar pip install <name> diretamente. Caso esteja na guia Pacotes (Conda), você verá conda install <name>:

Em ambos os casos, você pode personalizar a instalação pela adição de 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 do conteúdo da caixa de pesquisa:

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

Conceder privilégios de administrador à instalação do pacote

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

Elevar agora concede privilégios administrativos para executar o PIP para uma única operação, sujeita também a qualquer prompt de permissão do sistema operacional. Escolher Continuar sem privilégios de administrador tenta instalar o pacote, mas o PIP falha ao tentar criar pastas com uma saída como erro: não foi possível criar 'C:\Arquivos de Programas\Anaconda3\Lib\site-packages\png.py': permissão negada.

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

Nessa mesma guia de Opções, você também pode escolher Sempre executar o PIP como administrador para suprimir a caixa de diálogo para todos os ambientes. Consulte Opções – guia Geral.

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

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

O motivo para o aviso é que, com essas versões mais antigas do Python, pip install não dá suporte para o protocolo TLS 1.2, que é necessário para baixar pacotes da origem do pacote, pypi.org. Builds personalizados do Python talvez sejam compatíveis com TLS 1.2 e, nesse caso, pip install poderá funcionar.

É possível baixar o get-pip.py apropriado para um pacote em bootstrap.pypa.io, fazer o download manual de um pacote em pypi.org e, em seguida, instalar o pacote dessa cópia local.

No entanto, a recomendação é apenas atualizar para uma versão recente do Python; nesse caso, o aviso não é exibido.

Confira também

• Gerenciar ambientes do Python no Visual Studio
• Selecionar um interpretador para um projeto
• Usar requirements.txt para dependências
• Caminhos de pesquisa