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.
Um ambiente python é um contexto no qual você executa o código Python e inclui ambientes globais, virtuais e conda. Um ambiente consiste em um interpretador, uma biblioteca (normalmente a Biblioteca Padrão do Python) e um conjunto de pacotes instalados. Juntos, esses componentes determinam constructos de idioma válidos 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 do Python , conforme descrito neste artigo, para gerenciar ambientes e selecionar um como o padrão para novos projetos.
Você pode aprender sobre outros aspectos dos ambientes nos seguintes artigos:
Para qualquer projeto específico, 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 do Python, consulte Usar ambientes virtuais.
Se você quiser instalar pacotes em um ambiente, consulte a referência da guia Pacotes.
Para instalar outro interpretador do Python, consulte Instalar interpretadores do Python. Em geral, se você baixar e executar um instalador para uma distribuição principal do Python, o Visual Studio detectará essa nova instalação e o ambiente aparecerá na janela Ambientes do Python e poderá ser selecionado para projetos.
Observação
Você pode gerenciar ambientes para código Python que abrem como uma pasta selecionandoa pasta>>. A barra de ferramentas do Python permite alternar entre todos os ambientes detectados e também adicionar um novo ambiente. As informações de ambiente são armazenadas no arquivo PythonSettings.json no workspace .vs pasta.
Pré-requisitos
- Uma carga de trabalho do Python instalada
Se você é novo no Python no Visual Studio, consulte os seguintes artigos para obter um contexto geral:
A janela de Ambientes do Python
Os ambientes que o Visual Studio conhece são exibidos na janela Ambientes do Python . Para abrir a janela, use um dos seguintes métodos:
- Selecione Exibir>Outras Janelas>Ambientes Python.
- Clique com o botão direito do mouse no nó Ambientes do Python para um projeto no Gerenciador de Soluções e selecione Exibir Todos os Ambientes do Python.
A janela Ambientes do Python é exibida junto com o Gerenciador de Soluções 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 do Python , como o local do interpretador. Os comandos na parte inferior da guia Visão Geral abrem cada um um dos prompts de comando com o interpretador em execução. Para obter mais informações, consulte a referência da guia da janela Ambientes do Python – Visão geral.
Use a lista suspensa na lista de ambientes para alternar para guias diferentes, como Pacotes e IntelliSense. Essas guias também são descritas na guia de referência da janela de Ambientes do Python.
Selecionar 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 novos projetos. Para usar um ambiente diferente com novos projetos, use o comando Tornar este o ambiente padrão para novos projetos . No 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, está um controle que abre uma janela interativa para esse ambiente.
Observação
No Visual Studio 2017 15.5 e anterior, outro controle é exibido que atualiza o banco de dados do IntelliSense para esse ambiente. Para obter detalhes sobre o banco de dados, consulte a referência da guia da janela Ambientes do Python.
Dica
Ao expandir a janela Ambientes do Python suficientemente, você verá uma visão mais completa de seus ambientes, o que pode facilitar o trabalho com eles.
Dica
Ao expandir a janela Ambientes do Python com largura suficiente, você verá uma visão mais abrangente dos seus ambientes, o que facilita o trabalho.
Dica
Ao expandir a janela Ambientes do Python com largura suficiente, você verá uma visão mais completa de seus ambientes, o que pode tornar o trabalho mais conveniente.
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 nenhum ambiente aparecer?
Se você não vir nenhum ambiente na janela Ambientes do Python , isso significa que o Visual Studio falhou ao detectar quaisquer instalações do Python em locais padrão. Talvez você tenha instalado o Visual Studio 2017 ou posterior, mas desmarcado todas as opções de 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 do Python.
Se você souber que tem um interpretador do Python no computador, mas o Visual Studio (qualquer versão) não o detectou, use o comando + Personalizado 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 do Python.
Cada ambiente é composto pelo interpretador do Python específico, sua biblioteca padrão e um conjunto de pacotes pré-instalados. Ele também contém outros pacotes que você instala enquanto o ambiente é ativado. A instalação de um pacote em um ambiente global o disponibiliza para todos os projetos que usam esse ambiente. Se o ambiente estiver localizado em uma área protegida do sistema de arquivos (dentro de arquivos c:\program, por exemplo), a instalação de pacotes exigirá privilégios de administrador.
Ambientes globais estão disponíveis para todos os projetos no computador. No Visual Studio, você seleciona um ambiente global como o 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 projetos diferentes. A desordem pode dificultar o teste completo do 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 build 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 em um projeto que contém uma cópia de um interpretador específico. Se você ativar o ambiente virtual, todos os pacotes instalados serão instalados apenas na subpasta desse ambiente. Ao executar um programa Python dentro do ambiente virtual, você pode ter certeza de que o programa está em execução somente em relação a esses pacotes específicos.
O Visual Studio fornece suporte direto para a criação de um ambiente virtual para um projeto. Se você abrir um projeto que contenha um arquivo requirements.txt , o Visual Studio solicitará que você crie automaticamente um ambiente virtual e instale essas dependências. Você verá o mesmo comportamento ao criar um projeto a partir de um modelo que inclui requirements.txt arquivo.
A qualquer momento em 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 de Conda
Você pode criar um ambiente conda usando a ferramenta conda, ou com o gerenciamento integrado do conda no Visual Studio 2017 versão 15.7 e posterior. Um ambiente conda requer Anaconda ou Miniconda. Essas plataformas estão disponíveis por meio do Instalador do Visual Studio. Para obter mais informações, consulte Instalar o suporte do Python no Visual Studio.
Na janela Ambientes do Python ou na barra de ferramentas do 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 do ambiente conda. Adicionar pacotes de Especifica como adicionar pacotes ao ambiente conda.
- Arquivo de ambiente: selecione essa opção se você tiver um arquivo environment.yml que descreva suas dependências. Insira o nome do arquivo ou navegue (...) até o local do arquivo e selecione o arquivo.
- Um ou mais nomes de pacote anaconda: selecione esta opção se você quiser listar um ou mais pacotes python ou versões do Python.
A lista de pacotes instrui o Conda a criar um ambiente do 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 do Python e pacotes comuns em uma série de menus.Definir como ambiente atual Ativa o novo ambiente no projeto selecionado após a criação do ambiente. Definir como ambiente padrão para novos projetos Define e ativa automaticamente o ambiente conda em quaisquer novos projetos criados no Visual Studio. Essa opção é a mesma que usar a opção Definir este como o ambiente padrão para novos projetos na janela Ambientes do Python. Exibir na janela Ambientes do Python Especifica se a janela Ambientes do Python deve ser exibida após a criação do ambiente. Importante
Ao criar um ambiente conda, especifique pelo menos uma versão do Python ou um pacote python para garantir que o ambiente contenha um runtime 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 do Python , não é definido como o ambiente atual para um projeto e não está disponível como um ambiente global.
Se você criar um ambiente conda sem uma versão do Python, use o
conda infocomando para ver os locais das pastas de ambiente do 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 da CLI (interface de linha de comando), 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 da CLI (interface de linha de comando), como activate env:
No Visual Studio, você pode ativar um ambiente conda para seu projeto da mesma forma que faria com qualquer outro ambiente. Para obter mais informações, consulte Selecionar um ambiente para um projeto.
Para instalar mais pacotes no ambiente, use a guia Pacotes na janela de Ambientes Python.
Observação
Para obter melhores resultados com ambientes conda, use o Conda 4.4.8 ou posterior. Tenha em mente que as versões do Conda são diferentes das versões do Anaconda. Você pode instalar versões adequadas do Miniconda (Visual Studio 2019 e Visual Studio 2022) e anaconda (Visual Studio 2017) por meio do Instalador do Visual Studio.
Para ver a versão do Conda, em que os ambientes conda são armazenados e outras informações, execute o conda info comando em um prompt de comando do Anaconda (um prompt de comando em que Anaconda está no caminho):
conda info
As pastas de ambiente do 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 disponibiliza esse pacote para todos os projetos que usam o ambiente.
Para o Visual Studio 2017 versão 15.6 e anterior, 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 detecta ambientes conda automaticamente e os exibe na janela Ambientes do 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 diferente do padrão.
Na janela Ambientes do Python ou na barra de ferramentas do 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 serão adicionados à caixa de diálogo.
- Defina o campo Caminho de prefixo como o caminho do interpretador. Você pode definir o campo navegando (...) para a localização do caminho.
- Depois de selecionar o caminho, os campos restantes serão preenchidos. Examine os valores e modifique conforme necessário. Quando estiver pronto, selecione Adicionar.
Você também pode examinar e modificar detalhes do ambiente a qualquer momento na janela Ambientes do Python .
Na janela Ambientes do 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. Esse comando não está disponível para ambientes detectados automaticamente.
Corrigir ou excluir ambientes inválidos
Se o Visual Studio encontrar entradas de registro para um ambiente, mas o caminho para o interpretador for inválido, a janela Ambientes do Python mostrará o nome do ambiente em um formato de fonte de strikeout, conforme mostrado na imagem a seguir:
Para corrigir um ambiente que você deseja manter, primeiro tente usar o processo de Reparo do instalador de ambiente. A maioria dos instaladores inclui uma opção de reparo.
Modificar o registro para corrigir um ambiente
Se o ambiente do Python não tiver uma opção de reparo ou você quiser remover um ambiente inválido, você poderá usar as etapas a seguir para modificar o registro diretamente. O Visual Studio atualiza automaticamente a janela Ambientes do Python quando você faz alterações no registro.
Execute o regedit.exe executável para abrir o editor do Registro.
Navegue até a pasta de ambiente que corresponde à sua configuração:
Versão do Python Pasta 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 seu ambiente:
Distribuição Node CPython PythonCore><Nó da versão> Anaconda ContinuumAnalytics><>Nó de versão IronPython <Nó de versão> Inspecione os valores do nó InstallPath.
- Se o ambiente ainda existir em seu computador, altere o valor da entrada ExecutablePath para o local correto. Corrija também os valores das entradas (Padrão) e WindowedExecutablePath , conforme necessário.
- Se o ambiente não existir mais no seu computador e você quiser removê-lo da janela Ambientes do Python, exclua o nó pai do nó InstallPath que contém o número de versão. Você pode ver um exemplo desse nó na imagem anterior. No exemplo, o nó é 3.6.
Cuidado
Configurações inválidas na chave HKEY_CURRENT_USER\SOFTWARE\Python substituem as configurações na chave HKEY_LOCAL_MACHINE\SOFTWARE\Python .
Excluir ou remover um ambiente do Python
Para remover um projeto do Python, navegue até o ambiente do Python no Gerenciador de Soluções. Clique com o botão direito do mouse no ambiente do Python que você deseja remover e selecione Remover.
Se você quiser manter o ambiente do Python, mas removê-lo do projeto, selecione Remover. Se você quiser excluir o ambiente permanentemente, selecione Excluir.
