Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um ambiente Python é um contexto no qual você executa código Python e inclui ambientes globais, virtuais e conda. Um ambiente consiste em um interpretador, uma biblioteca (normalmente a Python Standard Library) e um conjunto de pacotes instalados. Esses componentes juntos determinam construções de linguagem válidas e sintaxe, funcionalidade do sistema operacional que você pode acessar e pacotes que você pode usar.
No Visual Studio no Windows, você usa a janela Ambientes Python , conforme descrito neste artigo, para gerenciar ambientes e selecionar um como padrão para novos projetos.
Você pode aprender sobre outros aspetos dos ambientes nos seguintes artigos:
Para qualquer projeto, você pode selecionar um ambiente específico em vez de usar o padrão.
Para obter detalhes sobre como criar e usar ambientes virtuais para projetos Python, consulte Usar ambientes virtuais.
Se você quiser instalar pacotes em um ambiente, consulte a referência da guia Pacotes.
Para instalar outro interpretador Python, consulte Instalar interpretadores Python. Em geral, se você baixar e executar um instalador para uma distribuição Python principal, o Visual Studio detetará que a nova instalação e o ambiente aparecerão na janela Ambientes Python e poderão ser selecionados para projetos.
Observação
Você pode gerenciar ambientes para código Python que abrem como uma pasta selecionando File>Open>Folder. A barra de ferramentas Python permite alternar entre todos os ambientes detetados e também adicionar um novo ambiente. As informações do ambiente são armazenadas no arquivo PythonSettings.json na pasta .vs do espaço de trabalho.
Pré-requisitos
- Uma carga de trabalho Python instalada
Se você é novo no Python no Visual Studio, consulte os seguintes artigos para obter informações gerais:
A janela Ambientes Python
Os ambientes que o Visual Studio conhece são exibidos na janela Ambientes Python . Para abrir a janela, use um dos seguintes métodos:
- Selecione Ver>Outras Janelas>Ambientes Python.
- Clique com o botão direito do mouse no nó Ambientes Python para um projeto no Gerenciador de Soluções e selecione Exibir Todos os Ambientes Python.
A janela Python Environments aparece ao lado do Solution Explorer no Visual Studio:
O Visual Studio procura ambientes globais instalados usando o registro (seguindo o PEP 514), juntamente com ambientes virtuais e ambientes conda. Se você não vir um ambiente esperado na lista, consulte Identificar manualmente um ambiente existente.
Quando você seleciona um ambiente na lista, o Visual Studio exibe várias propriedades e comandos para esse ambiente na guia Visão geral da janela Ambientes Python , como o local do interpretador. Os comandos na parte inferior da guia Visão geral abrem um prompt de comando com o intérprete em execução. Para obter mais informações, consulte Guia de Referência da Janela de Ambientes Python - Visão Geral.
Use a lista suspensa abaixo da lista de ambientes para alternar para guias diferentes, como Pacotes e IntelliSense. Essas guias também são descritas na referência da guia da janela Ambientes Python.
A seleção de um ambiente não altera sua relação com nenhum projeto. O ambiente padrão, mostrado em negrito na lista, é aquele que o Visual Studio usa para quaisquer novos projetos. Para usar um ambiente diferente com novos projetos, use o comando Tornar este o ambiente padrão para novos projetos . Dentro do contexto de um projeto, você sempre pode selecionar um ambiente específico. Para obter mais informações, consulte Selecionar um ambiente para um projeto.
À direita de cada ambiente listado, é um controle que abre uma janela interativa para esse ambiente.
Observação
No Visual Studio 2017 15.5 e anteriores, aparece outro controle que atualiza o banco de dados IntelliSense para esse ambiente. Para obter detalhes sobre a base de dados, consulte a referência do separador da janela Ambientes Python.
Sugestão
Quando você expande a janela Python Environments suficientemente ampla, você vê uma visão mais completa de seus ambientes que podem ser mais convenientes para trabalhar.
Sugestão
Quando você expande a janela Python Environments suficientemente ampla, você vê uma visão mais completa de seus ambientes que podem ser mais convenientes para trabalhar.
Sugestão
Quando você expande a janela Python Environments suficientemente ampla, você vê uma visão mais completa de seus ambientes que podem ser mais convenientes para trabalhar.
Observação
Embora o Visual Studio respeite a opção system-site-packages, ele não fornece uma maneira de alterá-lo de dentro do Visual Studio.
E se não aparecerem ambientes?
Se você não vir nenhum ambiente na janela Ambientes Python , isso significa que o Visual Studio não conseguiu detetar nenhuma instalação Python em locais padrão. Talvez você tenha instalado o Visual Studio 2017 ou posterior, mas tenha limpo todas as opções do interpretador nas opções do instalador para a carga de trabalho do Python. Da mesma forma, você possivelmente instalou o Visual Studio 2015 ou anterior, mas não instalou um interpretador manualmente. Para obter mais informações, consulte Instalar interpretadores Python.
Se você sabe que tem um interpretador Python em seu computador, mas o Visual Studio (qualquer versão) não o detetou, use o comando + Custom para especificar o local do interpretador manualmente. Para obter mais informações, consulte Identificar manualmente um ambiente existente.
Tipos de ambientes
O Visual Studio pode trabalhar com ambientes globais, virtuais e conda.
Ambientes globais
Cada instalação do Python mantém seu próprio ambiente global. Por exemplo, Python 2.7, Python 3.6, Python 3.7, Anaconda 4.4.0 e assim por diante. Para obter mais informações, consulte Instalar interpretadores Python.
Cada ambiente é composto pelo interpretador Python específico, sua biblioteca padrão e um conjunto de pacotes pré-instalados. Ele também contém quaisquer outros pacotes que você instala enquanto o ambiente está ativado. A instalação de um pacote em um ambiente global o torna disponível para todos os projetos que usam esse ambiente. Se o ambiente estiver localizado em uma área protegida do sistema de arquivos (dentro de c:\arquivos de programas, por exemplo), a instalação de pacotes exigirá privilégios de administrador.
Os ambientes globais estão disponíveis para todos os projetos no computador. No Visual Studio, você seleciona um ambiente global como padrão, que é usado para todos os projetos, a menos que você escolha especificamente um diferente para um projeto. Para obter mais informações, consulte Selecionar um ambiente para um projeto.
Ambientes virtuais
Trabalhar em um ambiente global é uma maneira fácil de começar. Com o tempo, os ambientes podem ficar confusos com muitos pacotes diferentes instalados para diferentes projetos. A confusão pode dificultar o teste completo de seu aplicativo em relação a um conjunto específico de pacotes com versões conhecidas. Mas esse tipo de ambiente é o que você esperaria configurar em um servidor de compilação ou servidor web. Conflitos também podem ocorrer quando dois projetos exigem pacotes incompatíveis ou versões diferentes do mesmo pacote.
Por esses motivos, os desenvolvedores geralmente criam um ambiente virtual para um projeto. Um ambiente virtual é uma subpasta num projeto que contém uma cópia de um intérprete específico. Se você ativar o ambiente virtual, todos os pacotes instalados serão instalados somente na subpasta desse ambiente. Quando você executa um programa Python dentro do ambiente virtual, você pode ter certeza de que o programa está sendo executado apenas em relação a esses pacotes específicos.
Visual Studio fornece suporte direto para a criação de um ambiente virtual para um projeto. Se você abrir um projeto que contém um arquivo requirements.txt , o Visual Studio solicitará automaticamente que você crie um ambiente virtual e instale essas dependências. Você vê o mesmo comportamento quando cria um projeto a partir de um modelo que inclui requirements.txt arquivo.
A qualquer momento dentro de um projeto aberto, você pode criar um novo ambiente virtual. No Gerenciador de Soluções, expanda o nó do projeto, clique com o botão direito do mouse em Ambientes Python e escolha Adicionar ambiente. Em Adicionar ambiente, escolha Ambiente virtual. Para obter mais informações, consulte Criar um ambiente virtual.
O Visual Studio também fornece um comando para gerar um arquivo requirements.txt de um ambiente virtual, facilitando a recriação do ambiente em outros computadores. Para obter mais informações, consulte Usar ambientes virtuais.
Ambientes Conda
Você pode criar um ambiente conda usando a ferramenta conda, ou com gerenciamento integrado do conda no Visual Studio 2017 versão 15.7 e versões posteriores. Um ambiente de conda requer Anaconda ou Miniconda. Essas plataformas estão disponíveis por meio do Visual Studio Installer. Para obter mais informações, consulte Instalar suporte a Python no Visual Studio.
Na janela Ambientes Python ou na barra de ferramentas Python, selecione Adicionar ambiente para abrir a caixa de diálogo Adicionar ambiente .
Na caixa de diálogo Adicionar ambiente , selecione a guia Ambiente Conda :
Configure os seguintes campos:
Campo Description Projeto Identifica o projeto no qual criar o ambiente. Nome Fornece o nome para o ambiente conda. Adicionar pacotes de Especifica como adicionar pacotes ao ambiente conda.
- Arquivo de ambiente: selecione esta opção se você tiver um arquivo environment.yml que descreva suas dependências. Digite o nome do arquivo ou procure (...) até o local do arquivo e selecione o arquivo.
- Um ou mais nomes de pacotes Anaconda: Selecione esta opção se quiser listar um ou mais pacotes Python ou versões do Python.
A lista de pacotes instrui o conda a criar um ambiente Python. Para instalar a versão mais recente do Python, use opythoncomando. Para instalar uma versão específica, use o comandopython=,major>.<minor>como empython=3.7. Você também pode usar o botão de pacote para selecionar versões Python e pacotes comuns em uma série de menus.Definir como ambiente atual Ativa o novo ambiente no projeto selecionado depois que o ambiente é criado. Definir como ambiente padrão para novos projetos Define e ativa automaticamente o ambiente conda em quaisquer novos projetos criados no Visual Studio. Esta opção é a mesma que usar o Tornar este o ambiente padrão para novos projetos na janela Ambientes Python. Visualizar na janela Ambientes Python Especifica se a janela Python Environments deve ser mostrada após a criação do ambiente. Importante
Ao criar um ambiente conda, certifique-se de especificar pelo menos uma versão do Python ou um pacote Python para garantir que o ambiente contenha um tempo de execução do Python. Você pode usar um arquivo environments.yml ou a lista de pacotes. Se você não fornecer essa especificação, o Visual Studio ignorará o ambiente. O ambiente não aparece em nenhum lugar na janela Ambientes Python , não está definido como o ambiente atual de um projeto e não está disponível como um ambiente global.
Se acontecer de você criar um ambiente conda sem uma versão Python, use o
conda infocomando para ver os locais das pastas do ambiente conda. Em seguida, você pode remover manualmente a subpasta do ambiente desse local.Selecione Criar.
Você pode monitorar a criação do ambiente conda na janela Saída . Após a conclusão da criação, a saída exibe algumas instruções de interface de linha de comando (CLI), como conda activate env:
Você pode monitorar a criação do ambiente conda na janela Saída . Após a conclusão da criação, a saída exibe algumas instruções de interface de linha de comando (CLI), como activate env:
No Visual Studio, você pode ativar um ambiente conda para seu projeto da mesma maneira que faria com qualquer outro ambiente. Para obter mais informações, consulte Selecionar um ambiente para um projeto.
Para instalar mais pacotes no ambiente, utilize a guia "Pacotes" na janela Ambientes Python.
Observação
Para obter melhores resultados com ambientes de conda, use o conda 4.4.8 ou posterior. Tenha em mente que as versões conda são diferentes das versões Anaconda. Você pode instalar versões adequadas do Miniconda (Visual Studio 2019 e Visual Studio 2022) e do Anaconda (Visual Studio 2017) por meio do Visual Studio Installer.
Para ver a versão do conda, onde os ambientes conda são armazenados, e outras informações, execute o comando conda info em um prompt de comando Anaconda (um prompt de comando onde o Anaconda está no PATH):
conda info
Suas pastas de ambiente conda aparecem da seguinte maneira:
envs directories : C:\Users\user\.conda\envs
c:\anaconda3\envs
C:\Users\user\AppData\Local\conda\conda\envs
Como os ambientes conda não são armazenados com um projeto, eles se comportam de forma semelhante aos ambientes globais. Por exemplo, a instalação de um novo pacote em um ambiente conda torna esse pacote disponível para todos os projetos que usam o ambiente.
Para o Visual Studio 2017 versão 15.6 e anteriores, você pode usar ambientes conda apontando para eles manualmente, conforme descrito em Identificar manualmente um ambiente existente.
O Visual Studio 2017 versão 15.7 e posterior deteta ambientes conda automaticamente e os exibe na janela Ambientes Python , conforme descrito na próxima seção.
Identificar manualmente um ambiente existente
Use as etapas a seguir para identificar um ambiente instalado em um local fora do padrão.
Na janela Ambientes Python ou na barra de ferramentas Python, selecione Adicionar ambiente para abrir a caixa de diálogo Adicionar ambiente .
Na caixa de diálogo Adicionar ambiente , na guia Ambiente existente , defina o campo Ambiente como <Personalizado>:
Depois de selecionar o <valor personalizado> , mais campos são adicionados à caixa de diálogo.
- Defina o campo Caminho do prefixo como o caminho do intérprete. Você pode definir o campo navegando (...) até o local do caminho.
- Depois de selecionar o caminho, os campos restantes são preenchidos. Revise os valores e modifique conforme necessário. Quando estiver pronto, selecione Adicionar.
Você também pode revisar e modificar detalhes do ambiente a qualquer momento na janela Ambientes Python .
Na janela Ambientes Python , selecione o ambiente e, em seguida, selecione a guia Configurar .
Depois de fazer alterações, selecione o comando Aplicar .
Você também pode remover o ambiente usando o comando Remover . Para obter mais informações, consulte a guia Configurar. Este comando não está disponível para ambientes detetados automaticamente.
Corrigir ou excluir ambientes inválidos
Se o Visual Studio detetar entradas do registo para um ambiente, mas o caminho para o interpretador for inválido, a janela Ambientes Python mostrará o nome do ambiente em formato de fonte riscado, conforme mostrado na imagem a seguir:
Para corrigir um ambiente que você deseja manter, primeiro tente usar o processo de reparo do instalador do ambiente. A maioria dos instaladores inclui uma opção de reparo.
Modificar o registro para corrigir um ambiente
Se o ambiente Python não tiver uma opção de reparo, ou se você quiser remover um ambiente inválido, você pode usar as etapas a seguir para modificar o registro diretamente. O Visual Studio atualiza automaticamente a janela Ambientes Python quando você faz alterações no Registro.
Execute o regedit.exe para abrir o editor do Registo.
Navegue até a pasta de ambiente que corresponde à sua configuração:
Versão de Python Folder Versão de 64 bits HKEY_LOCAL_MACHINE\SOFTWARE\Python ou HKEY_CURRENT_USER\Software\Python Versão de 32 bits HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python IronPython IronPython Expanda a estrutura de nós de distribuição e versão para o seu ambiente:
Distribuição Node CPython PythonCore><Nó de versão> Anaconda ContinuumAnalytics><Versão do nó> IronPython <Nó da versão> Inspecione os valores no nó InstallPath :
- Se o ambiente ainda existir no seu computador, altere o valor da entrada ExecutablePath para o local correto. Também corrija os valores para as entradas (Default) e WindowedExecutablePath , conforme necessário.
- Se o ambiente já não existir no seu computador e pretender removê-lo da janela Python Environments, remova o nó pai que contém o número da versão do nó InstallPath. Você pode ver um exemplo deste nó na imagem anterior. No exemplo, este nó é 3.6.
Atenção
As configurações inválidas na tecla HKEY_CURRENT_USER\SOFTWARE\Python substituem as configurações na tecla HKEY_LOCAL_MACHINE\SOFTWARE\Python .
Excluir ou remover um ambiente Python
Para remover um projeto Python, navegue até o ambiente Python no Gerenciador de Soluções. Clique com o botão direito do mouse no ambiente Python que você deseja remover e selecione Remover.
Se você quiser manter o ambiente Python, mas removê-lo do seu projeto, selecione Remover. Se quiser excluir o ambiente permanentemente, selecione Excluir.
