Instalar interpretadores do Python
Existem diversas opções para instalar interpretadores do Python e trabalhar com o Visual Studio. É possível instalar um interpretador no momento da instalação da carga de trabalho do Python ou depois que uma carga de trabalho estiver presente. Também é possível instalar interpretadores manualmente fora do Instalador do Visual Studio.
Quando você instala a carga de trabalho de desenvolvimento do Python no Visual Studio 2017 e em versões posteriores, 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 a versão de 64 bits do Python 2 ou do Python 3 com o Miniconda (Visual Studio 2019) ou o Anaconda 2/Anaconda 3 (Visual Studio 2017). As etapas para essa modalidade de instalação estão em Instalar o suporte ao Python no Visual Studio.
Como alternativa, você pode instalar os interpretadores padrão do Python utilizando 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.
Também é possível instalar os interpretadores do Python manualmente fora do Instalador do Visual Studio. Suponha que você instale o Anaconda 3 antes de instalar o Visual Studio. Não é necessário instalar o Anaconda novamente por meio do Instalador do Visual Studio. Também é possível instalar uma versão mais recente de um interpretador que ainda não esteja listada no Instalador do Visual Studio.
Pré-requisitos
O Visual Studio dá suporte ao Python versão 3.7. Embora seja possível utilizar uma versão anterior do Visual Studio para editar código escrito em versões anteriores do Python, essas versões do Python não recebem suporte oficial. Alguns recursos do Visual Studio, como o IntelliSense e a depuração, podem não funcionar com versões anteriores do Python.
Para o Visual Studio 2015 e versões anteriores, utilize o Python 3.5 ou versões anteriores. É necessário instalar manualmente um dos interpretadores do Python.
Distribuições do Anaconda
Embora o Visual Studio ofereça a instalação da distribuição do Anaconda, seu uso da distribuição e de outros pacotes do Repositório do Anaconda são associados pelos Termos de Serviço do Anaconda. Esses termos podem exigir que algumas organizações paguem ao Anaconda por uma licença comercial ou configurem as ferramentas para acessar um repositório alternativo. Para obter mais informações, consulte a documentação de canais do Conda.
Lista de interpretadores do Python
A tabela a seguir lista os interpretadores do Python que podem ser utilizados com o Visual Studio.
| Interpretador | Descrição | Observações |
|---|---|---|
| CPython | O interpretador “nativo” e mais usado, disponível em versões de 32 e 64 bits (o recomendado é 32 bits). Inclui os últimos recursos de linguagem, a compatibilidade máxima com pacotes do Python, suporte de depuração completo e interoperabilidade com o IPython. Revise as considerações em Devo usar o Python 2 ou 3? para determinar qual versão do Python deve instalar. | O Visual Studio 2015 e versões anteriores não oferecem suporte ao Python 3.6 ou versões posteriores e podem gerar erros, como Python versão 3.6 sem suporte. Para o Visual Studio 2015 e versões anteriores, utilize o Python 3.5 ou versões anteriores. |
| IronPython | Uma implementação .NET do Python, disponível nas versões de 32 e 64 bits. Fornece interoperabilidade entre C#/F#/Visual Basic, acesso às APIs .NET, depuração padrão do Python (mas não depuração de modo misto em C++) e depuração mista em IronPython/C#. | O IronPython não oferece suporte a ambientes virtuais. |
| Anaconda | Uma plataforma aberta de ciência de dados baseada em Python. Inclui a versão mais recente do CPython e a maioria dos pacotes difíceis de instalar. | Se você não conseguir decidir qual interpretador usar, recomendamos o uso do Anaconda. |
| PyPy | Uma implementação JIT de rastreamento de alto desempenho do Python. Boa para programas de execução prolongada e situações em que são identificados problemas de desempenho, mas não são encontradas outras resoluções. | Funciona com o Visual Studio, mas com suporte limitado para recursos de depuração avançados. |
| 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 de depuração avançados. |
Detectar o ambiente
O Visual Studio exibe todos os ambientes conhecidos na janela Ambientes do Python. Ele detecta automaticamente as atualizações em 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 do Python, consulte Detecção para ambiente da PTVS (github.com).
Entradas do Registro
O Visual Studio (todas as versões) detecta automaticamente cada interpretador Python instalado e seu ambiente verificando o Registro, de acordo com o PEP 514 – registro do Python no Registro do Windows. Geralmente, as instalações do Python se encontram nas chaves HKEY_LOCAL_MACHINE\SOFTWARE\Python (32 bits) e HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python (64 bits) nos nós da 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 o 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 de instalação, use as etapas a seguir para reinstalar o interpretador no novo local:
- Restaure o interpretador do Python para o local original.
- Desinstale-o usando o instalador, que limpa as entradas do Registro.
- Reinstale o interpretador no novo local.
- Reinicie o Visual Studio, que deve detectar automaticamente o novo local em vez do local antigo.
Esse processo garante que as entradas do Registro que identificam o local do interpretador, usado pelo Visual Studio, sejam atualizadas corretamente. O uso de um instalador também lida com outros efeitos colaterais que possam existir.