Instalación de intérpretes de Python

Hay varias opciones para instalar intérpretes de Python para trabajar con Visual Studio. Puede instalar un intérprete al instalar la carga de trabajo de Python o puede hacerlo después de que haya una carga de trabajo presente. Los intérpretes también se pueden instalar manualmente fuera del instalador de Visual Studio.

Al instalar la carga de trabajo de desarrollo de Python en Visual Studio 2017 y versiones posteriores, también se instala Python 3 (64 bits) de forma predeterminada. De manera opcional, puede optar por instalar la versión de Python 2 o Python 3 de 32 y 64 bits, junto con Miniconda (Visual Studio 2019) o Anaconda2/Anaconda 3 (Visual Studio 2017). Los pasos para este tipo de instalación se describen en Instalación de compatibilidad con Python en Visual Studio.

Un enfoque alternativo consiste en instalar intérpretes estándar de Python mediante la característica Agregar entorno en Visual Studio. Esta opción está disponible en la ventana Entornos de Python y en la barra de herramientas de Python.

Los intérpretes de Python también se pueden instalar manualmente fuera del instalador de Visual Studio. Supongamos que instala Anaconda 3 antes de instalar Visual Studio. No es necesario volver a instalar Anaconda a través del Instalador de Visual Studio. También puede instalar una versión más reciente de un intérprete si aún no aparece en el Instalador de Visual Studio.

Requisitos previos

  • Visual Studio admite la versión 3.7 de Python. Aunque es posible usar una versión anterior de Visual Studio para editar el código escrito en versiones anteriores de Python, esas versiones de Python no se admiten oficialmente. Es posible que las características de Visual Studio, como IntelliSense y la depuración, no funcionen con versiones anteriores de Python.

  • Para Visual Studio 2015 y versiones anteriores, use Python 3.5 o versiones anteriores. Debe instalar manualmente uno de los intérpretes de Python.

Distribuciones de Anaconda

Aunque Visual Studio ofrece instalar la distribución de Anaconda, el uso de esta distribución y de otros paquetes del repositorio de Anaconda se rige por los términos de servicio de Anaconda. Estos términos pueden requerir que algunas organizaciones tengan que pagar una licencia comercial a Anaconda o bien configurar herramientas para acceder a un repositorio alternativo. Para obtener más información, consulte la documentación de los canales de Conda.

Revisión de intérpretes de Python

En la tabla siguiente se enumeran los intérpretes de Python que se pueden usar con Visual Studio.

Intérprete Descripción Notas
CPython Intérprete "nativo" y que se usa con más frecuencia, disponible en versiones de 32 y 64 bits (se recomienda la versión de 32 bits). Incluye características más recientes del lenguaje, máxima compatibilidad con paquetes de Python, compatibilidad completa con la depuración e interoperabilidad con IPython. Revise las consideraciones de ¿Debo usar Python 2 o Python 3? para ayudar a determinar qué versión de Python se va a instalar. Visual Studio 2015 y versiones anteriores no admiten Python 3.6 o posterior y pueden generar errores de tipo Versión 3.6 de Python no compatible. Para Visual Studio 2015 y versiones anteriores, use Python 3.5 o versiones anteriores.
IronPython Una implementación de .NET de Python, disponible en versiones de 32 y 64 bits. Proporciona interoperabilidad de C#/F#/Visual Basic, acceso a las API de .NET, depuración estándar de Python (pero no depuración en modo mixto de C++) y depuración mixta de IronPython/C#. IronPython no admite entornos virtuales.
Anaconda Una plataforma de ciencia de datos abierta con tecnología de Python. Incluye la última versión de CPython y la mayoría de los paquetes difíciles de instalar. Si no puede tomar una decisión sobre un intérprete, se recomienda usar Anaconda.
PyPy Implementación JIT de seguimiento de alto rendimiento de Python. Es bueno para programas de larga duración y situaciones en las que se identifican problemas de rendimiento pero no se pueden encontrar otras soluciones. Funciona con Visual Studio, pero con compatibilidad limitada para características de depuración avanzadas.
Jython Implementación de Python en la Máquina virtual Java (JVM). De forma similar a IronPython, el código que se ejecuta en Jython puede interactuar con las bibliotecas y clases de Java. Sin embargo, es posible que no se pueda acceder a muchas de las bibliotecas diseñadas para CPython. Funciona con Visual Studio, pero con compatibilidad limitada para características de depuración avanzadas.

Detección del entorno

Visual Studio muestra todos los entornos conocidos en la ventana Entornos de Python. Detecta automáticamente las actualizaciones de los intérpretes existentes.

Si Visual Studio no detecta un entorno instalado, consulte Identificación manual de un entorno existente.

So desea proporcionar nuevas formas de detección para entornos de Python, consulte Detección de entorno de PTVS (github.com).

Entradas del registro

Visual Studio (todas las versiones) detecta automáticamente cada intérprete de Python instalado y su entorno mediante la comprobación del registro de acuerdo con PEP 514 - Python registration in the Windows registry (PEP 514: registro de Python en el Registro de Windows). Las instalaciones de Python se encuentran normalmente en las claves HKEY_LOCAL_MACHINE\SOFTWARE\Python (32 bits) y HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python (64 bits) dentro de los nodos para la distribución, como PythonCore (CPython) y ContinuumAnalytics (Anaconda).

Trasladar un intérprete

Si mueve un intérprete existente a una ubicación nueva con el sistema de archivos, Visual Studio no detecta automáticamente el cambio.

  • Si originalmente ha especificado la ubicación del intérprete a través de la ventana Entornos de Python, puede editar su entorno con la pestaña Configurar de esa ventana para identificar la ubicación nueva. Para obtener más información, consulte Identificación manual de un entorno existente.

  • Si instaló el intérprete con un programa de instalación, siga estos pasos para volver a instalar el intérprete en la ubicación nueva:

    1. Restaure el intérprete de Python a su ubicación original.
    2. Desinstale el intérprete mediante el instalador, que borra las entradas del Registro.
    3. Vuelva a instalar el intérprete en la nueva ubicación.
    4. Reinicie Visual Studio, que debería detectar automáticamente la ubicación nueva en lugar de la antigua.

Este proceso garantiza que las entradas del registro que identifican la ubicación del intérprete, que Visual Studio usa, se actualizan correctamente. Usar un instalador también controla cualquier otro efecto secundario que pudiera surgir.