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.
Há várias opções para instalar interpretadors do Python para trabalhar com o Visual Studio. Você pode instalar um interpretador ao instalar a carga de trabalho do Python ou instalar um interpretador depois que uma carga de trabalho estiver presente. Os interpretados também podem ser instalados manualmente fora do Instalador do Visual Studio.
Quando você instala a carga de trabalho de desenvolvimento do Python no Visual Studio 2017 e posterior, o Python 3 (64 bits) também é instalado por padrão. Como opção, você pode optar por instalar a versão de 32 bits ou 64 bits do Python 2 ou Python 3, juntamente com o Miniconda (Visual Studio 2019) ou o Anaconda 2/Anaconda 3 (Visual Studio 2017). Para obter as etapas de instalação, consulte Instalar o suporte do Python no Visual Studio.
Uma abordagem alternativa é instalar interpretadores padrão do Python usando o recurso Adicionar Ambiente no Visual Studio. Essa opção está disponível na janela Ambientes do Python e na barra de ferramentas do Python.
Os interpretadors do Python também podem ser instalados manualmente fora do Instalador do Visual Studio. Suponha que você instale o Anaconda 3 antes de instalar o Visual Studio. Você não precisa reinstalar o Anaconda por meio do Instalador do Visual Studio. Você também pode instalar uma versão mais recente de um interpretador se ele ainda não estiver listado no Instalador do Visual Studio.
Pré-requisitos
O Visual Studio dá suporte ao Python versão 3.7. Embora seja possível usar uma versão anterior do Visual Studio para editar o código escrito em versões anteriores do Python, essas versões do Python não têm suporte oficial. Recursos do Visual Studio, como IntelliSense e depuração, podem não funcionar com versões anteriores do Python.
Para o Visual Studio 2015 e anterior, use o Python 3.5 ou anterior. Você deve instalar manualmente um dos interpretadors do Python.
Distribuições do Anaconda
Embora o Visual Studio ofereça instalar a distribuição anaconda, o uso da distribuição e outros pacotes do Repositório Anaconda são associados pelos termos de serviço do Anaconda. Esses termos podem exigir que algumas organizações paguem a Anaconda por uma licença comercial ou então configurem as ferramentas para acessar um repositório alternativo. Para obter mais informações, consulte a documentação dos canais do Conda.
Examinar interpretadors do Python
A tabela a seguir lista os interpretadores do Python que podem ser usados com o Visual Studio.
| Intérprete | Descrição | Anotações |
|---|---|---|
| CPython | O interpretador nativo e mais usado, disponível em versões de 32 bits e 64 bits (recomendado de 32 bits). Inclui os recursos de idioma mais recentes, a compatibilidade máxima do pacote python, o suporte completo de depuração e a interoperabilidade com o IPython. Para determinar qual versão do Python instalar, consulte Devo usar Python 2 ou Python 3?. | O Visual Studio 2015 e anteriores não dão suporte ao Python 3.6 ou posterior e podem retornar erros como o Python sem suporte versão 3.6. Para o Visual Studio 2015 e anterior, use o Python 3.5 ou anterior. |
| IronPython | Uma implementação do .NET do Python, disponível em versões de 32 bits e 64 bits. Fornece interoperabilidade C#/F#/Visual Basic, acesso a APIs .NET, depuração padrão do Python (mas não depuração de modo misto C++) e depuração mista de IronPython/C#. | O IronPython não dá suporte a ambientes virtuais. |
| Anaconda | Uma plataforma de ciência de dados aberta alimentada pelo Python. Inclui a versão mais recente do CPython e a maioria dos pacotes difíceis de instalar. | Se você não conseguir decidir sobre um interpretador, recomendamos usar o Anaconda. |
| PyPy | Uma implementação JIT de rastreamento de alto desempenho do Python. Bom para programas de longa execução e situações em que você identifica problemas de desempenho, mas não consegue encontrar outras resoluções. | Funciona com o Visual Studio, mas com suporte limitado para recursos avançados de depuração. |
| Jython | Uma implementação do Python na JVM (Máquina Virtual Java). Semelhante ao IronPython, o código em execução no Jython pode interagir com classes e bibliotecas Java. No entanto, muitas das bibliotecas destinadas ao CPython podem não estar acessíveis. | Funciona com o Visual Studio, mas com suporte limitado para recursos avançados de depuração. |
Detectar seu ambiente
O Visual Studio mostra todos os ambientes conhecidos na janela Ambientes do Python . Ele detecta automaticamente atualizações para interpretadores existentes.
Se o Visual Studio não detectar um ambiente instalado, consulte Identificar manualmente um ambiente existente.
Se você quiser fornecer novas formas de detecção para ambientes python, consulte a Detecção de Ambiente PTVS no GitHub.
Entradas do Registro
O Visual Studio (todas as versões) detecta automaticamente cada interpretador do Python instalado e seu ambiente verificando o registro de acordo com o REGISTRO PEP 514 – Python no registro do Windows. As instalações do Python normalmente são encontradas sob a chave HKEY_LOCAL_MACHINE\SOFTWARE\Python (32 bits) e HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python (64 bits) em nós para a distribuição, como PythonCore (CPython) e ContinuumAnalytics (Anaconda).
Mover um interpretador
Se você mover um interpretador existente para um novo local usando o sistema de arquivos, o Visual Studio não detectará automaticamente a alteração.
Se você especificou originalmente o local do interpretador por meio da janela Ambientes do Python , poderá editar seu ambiente usando a guia Configurar nessa janela para identificar o novo local. Para obter mais informações, consulte Identificar manualmente um ambiente existente.
Se você instalou o interpretador usando um programa instalador, use as seguintes etapas para reinstalar o interpretador no novo local:
- Restaure o interpretador do Python para seu local original.
- Desinstale o interpretador usando seu instalador, que limpa as entradas do Registro.
- Reinstale o interpretador no novo local.
- Reinicie o Visual Studio, que deve fazer a detecção automática do novo local no lugar do local antigo.
Esse processo garante que as entradas do Registro que identificam a localização do interpretador, que o Visual Studio usa, sejam atualizadas corretamente. O uso de um instalador também manipula quaisquer outros efeitos colaterais que possam existir.