Instalación de la compatibilidad con Python en Visual Studio en Windows

Para instalar la compatibilidad de Python para Visual Studio (también conocida como Herramientas de Python para Visual Studio o PTVS), siga las instrucciones que aparecen en la sección correspondiente a su versión de Visual Studio:

• Visual Studio 2017 y Visual Studio 2019
• Visual Studio 2015
• Visual Studio 2013 y anterior

Para probar rápidamente la compatibilidad de Python después de seguir los pasos de instalación, abra la ventana interactiva de Python; para ello, presione Alt+I y escriba 2+2. Si no ve la salida de 4, revise los pasos.

Visual Studio 2019 y Visual Studio 2017

1. Descargue y ejecute el instalador de Visual Studio más reciente. Si tiene Visual Studio ya instalado, ejecute el Instalador de Visual Studio, seleccione la opción Modificar (consulte Modificar Visual Studio) y vaya al paso 2.

   Instalación de Visual Studio 2019 Community

   Sugerencia

   La edición Community es para desarrolladores individuales, aprendizaje en el aula, investigación académica y desarrollo de código abierto. Para otros usos, instale Visual Studio 2019 Professional o Visual Studio 2019 Enterprise.

2. El instalador muestra una lista de las cargas de trabajo, que son grupos de opciones relacionadas para áreas de desarrollo específicas. Para Python, seleccione la carga de trabajo Desarrollo de Python.

   

   Opcional: si está trabajando con la ciencia de datos, considere también la posibilidad de la carga de trabajo Aplicaciones de ciencia de datos y de análisis. Esta carga de trabajo incluye compatibilidad con los lenguajes Python, R y F#. Para más información, vea Carga de trabajo Aplicaciones de ciencia de datos y de análisis.

   Nota

   Las cargas de trabajo de Python y Ciencia de datos solo están disponibles con Visual Studio 2017 versión 15.2 y posteriores.

   Opcional: si está trabajando con la ciencia de datos, considere también la posibilidad de la carga de trabajo Aplicaciones de ciencia de datos y de análisis. Esta carga de trabajo incluye compatibilidad con los lenguajes Python y F#. Para más información, vea Carga de trabajo Aplicaciones de ciencia de datos y de análisis.

3. En la parte derecha del instalador, puede elegir opciones adicionales si lo prefiere. Omita este paso para aceptar las opciones predeterminadas.

   

   

   Opción	Descripción
   Distribuciones de Python	Elija cualquier combinación de las opciones disponibles, como las variantes de 32 bits y 64 bits de las distribuciones de Python 2, Python 3, Miniconda, Anaconda2 y Anaconda3 con las que piensa trabajar. En todas se incluye el intérprete, el runtime y las bibliotecas de la distribución. Anaconda, en concreto, es una plataforma abierta de ciencia de datos que incluye una gran variedad de paquetes preinstalados. (Puede volver al instalador de Visual Studio en cualquier momento para agregar o quitar distribuciones). Nota: Si ha instalado una distribución fuera del instalador de Visual Studio, no es necesario comprobar la opción equivalente aquí. Visual Studio detecta automáticamente las instalaciones existentes de Python. Vea La ventana Entornos de Python. Además, si hay una versión más reciente de Python que la que se muestra en el instalador, puede instalar esta versión por separado y Visual Studio la detectará.
   Compatibilidad con plantillas de Cookiecutter	Instala la interfaz de usuario gráfica de Cookiecutter para detectar plantillas, opciones de plantilla de entrada y crear proyectos y archivos. Vea Uso de la extensión Cookiecutter.
   Compatibilidad web con Python	Instala herramientas para desarrollo web, incluida la compatibilidad de edición de HTML, CSS y JavaScript, junto con plantillas de proyectos que usan los marcos Bottle, Flask y Django. Vea Plantillas de proyecto web de Python.
   Compatibilidad con IoT de Python	Admite el desarrollo de Windows IoT Core con Python.
   Herramientas de desarrollo nativo de Python	Instala el compilador de C++ y otros componentes necesarios para desarrollar extensiones nativas para Python. Vea Creación de una extensión de C++ para Python. Instale también la carga de trabajo Desarrollo para el escritorio con C++ para disfrutar de una compatibilidad plena.

   Opción	Descripción
   Distribuciones de Python	Elija cualquier combinación de las opciones disponibles, como las variantes de 32 bits y 64 bits de las distribuciones de Python 2, Python 3, Miniconda, Anaconda2 y Anaconda3 con las que piensa trabajar. En todas se incluye el intérprete, el runtime y las bibliotecas de la distribución. Anaconda, en concreto, es una plataforma abierta de ciencia de datos que incluye una gran variedad de paquetes preinstalados. (Puede volver al instalador de Visual Studio en cualquier momento para agregar o quitar distribuciones). Nota: Si ha instalado una distribución fuera del instalador de Visual Studio, no es necesario comprobar la opción equivalente aquí. Visual Studio detecta automáticamente las instalaciones existentes de Python. Vea La ventana Entornos de Python. Además, si hay una versión más reciente de Python que la que se muestra en el instalador, puede instalar esta versión por separado y Visual Studio la detectará.
   Compatibilidad con plantillas de Cookiecutter	Instala la interfaz de usuario gráfica de Cookiecutter para detectar plantillas, opciones de plantilla de entrada y crear proyectos y archivos. Vea Uso de la extensión Cookiecutter.
   Compatibilidad web con Python	Instala herramientas para desarrollo web, incluida la compatibilidad de edición de HTML, CSS y JavaScript, junto con plantillas de proyectos que usan los marcos Bottle, Flask y Django. Vea Plantillas de proyecto web de Python.
   Herramientas de desarrollo nativo de Python	Instala el compilador de C++ y otros componentes necesarios para desarrollar extensiones nativas para Python. Vea Creación de una extensión de C++ para Python. Instale también la carga de trabajo Desarrollo para el escritorio con C++ para disfrutar de una compatibilidad plena.

4. Después de la instalación, el instalador proporciona opciones para modificar, iniciar, reparar o desinstalar Visual Studio. El botón Modificar cambia a Actualizar cuando hay actualizaciones de Visual Studio disponibles para alguno de los componentes instalados. (Después, la opción Modificar está disponible en el menú desplegable). También puede iniciar Visual Studio y el instalador desde el menú Inicio de Windows mediante la búsqueda de "Visual Studio".

   

Solución de problemas

Si encuentra problemas al instalar o ejecutar Python en Visual Studio, pruebe lo siguiente:

• Determinar si se produce el mismo error mediante la CLI de Python, es decir, ejecutar python.exe desde un símbolo del sistema.
• Use la opción Reparar en el instalador de Visual Studio.
• Reparar o reinstalar Python a través de Configuración > Aplicaciones y características en Windows.

Error de ejemplo: No se pudo iniciar el proceso interactivo: System.ComponentModel.Win32Exception (0x80004005): Error desconocido (0xc0000135) en Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext().

Visual Studio 2015

1. Ejecute el instalador de Visual Studio; para ello, vaya a Panel de control > Programas y características, seleccione Microsoft Visual Studio 2015 y después haga clic en Cambiar.

2. En el instalador, seleccione Modificar.

3. Seleccione Lenguajes de programación > Herramientas de Python para Visual Studio y luego haga clic en Siguiente:

   

4. Una vez completada la instalación de Visual Studio, instale un intérprete de Python de su elección. Visual Studio 2015 solo admite Python 3.5 y versiones anteriores, las versiones más recientes generan un mensaje similar a Versión 3.6 de Python no compatible). Si ya tiene instalado un intérprete y Visual Studio no lo detecta de manera automática, consulte Identificación manual de un entorno existente.

Visual Studio 2013 y anterior

1. Instale la versión adecuada de Herramientas de Python para Visual Studio para su versión de Visual Studio:

   • Visual Studio 2013: PTVS 2.2.2 para Visual Studio 2013. En el cuadro de diálogo Archivo > Nuevo proyecto de Visual Studio 2013 se ofrece un acceso directo a este proceso.
   • Visual Studio 2010 y 2012: PTVS 2.1.1 para Visual Studio 2010 y 2012

2. Instale un intérprete de Python de su elección. Si ya tiene instalado un intérprete y Visual Studio no lo detecta de manera automática, consulte Identificación manual de un entorno existente.

Ubicaciones de instalación

De forma predeterminada, la compatibilidad de Python se instala para todos los usuarios de un equipo.

En Visual Studio 2019 y Visual Studio 2017, la carga de trabajo de Python se instala en %ProgramFiles(x86)%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python, donde <VS_version> es 2019 o 2017 y <VS_edition> es Community, Professional o Enterprise.

En Visual Studio 2015 y versiones anteriores, las rutas de instalación son las siguientes:

• 32 bits:
  • Ruta de acceso: %Archivos de programa(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Herramientas de Python para Visual Studio\<PTVS_ver>
  • Ubicación del Registro de ruta de acceso: HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDir
• 64 bits:
  • Ruta de acceso: %Archivos de programa%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Herramientas de Python para Visual Studio\<PTVS_ver>
  • Ubicación del Registro de ruta de acceso: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDir

donde:

• <VS_ver> es:
  • 14.0 para Visual Studio 2015
  • 12.0 para Visual Studio 2013
  • 11.0 para Visual Studio 2012
  • 10.0 para Visual Studio 2010
• <PTVS_ver> es un número de versión, como 2.2.2, 2.1.1, 2.0, 1.5, 1.1 o 1.0.

Instalaciones específicas de usuario (1.5 y anteriores)

Herramientas de Python para Visual Studio 1.5 y las versiones anteriores permitían una instalación solo para el usuario actual, en cuyo caso la ruta de instalación es %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Herramientas de Python para Visual Studio\<PTVS_ver> , donde <VS_ver> y <PTVS_ver> se corresponden con las mismas versiones indicadas anteriormente.