Referencia de pestañas de ventana Entornos de Python en Herramientas de Python para Visual Studio

Para abrir la ventana Entornos de Python:

• Seleccione el comando de menú Vista>Otras ventanas>Entornos de Python.
• Haga clic con el botón derecho en el nodo Entornos de Python de un proyecto en el Explorador de soluciones y seleccione View All Python Environments (Ver todos los entornos de Python).

Si expande la ventana Entornos de Python con un ancho suficiente, estas opciones se muestran como pestañas, lo cual puede resultarle más cómodo. Para mayor claridad, en este artículo las pestañas se muestran en la vista expandida.

Pestaña: Información general

Proporciona información básica y comandos para el entorno:

Get-Help	Descripción
Hacer que este entorno sea el predeterminado para los proyectos nuevos	Establece el entorno activo, que puede hacer que Visual Studio (2017, versión 15.5 y anteriores) deje de responder por unos instantes mientras se carga la base de datos de IntelliSense. Los entornos con muchos paquetes pueden dejar de responder durante más tiempo.
Visitar el sitio web del distribuidor	Abre un explorador en la URL proporcionada por la distribución de Python. Python 3.x, por ejemplo, se dirige a python.org.
Abrir ventana interactiva	Abre la ventana interactiva (REPL) para este entorno en Visual Studio, aplicando cualquiera de los scripts de inicio (ver a continuación).
Explorar scripts interactivos	Vea Scripts de inicio.
Usar el modo interactivo de IPython	Cuando se establece, se abre la ventana interactiva con IPython de manera predeterminada. Esto habilita los gráficos en línea, así como la sintaxis de IPython extendida como name? para ver la ayuda y !command para los comandos del shell. Esta opción se recomienda al usar una distribución de Anaconda, ya que necesita paquetes adicionales. Para obtener más información, vea Uso de IPython en la ventana interactiva.
Abrir en PowerShell	Inicie el intérprete en una ventana de comandos de PowerShell.
(Vínculos de carpeta y programa)	Le proporcionan acceso rápido a la carpeta de instalación del entorno, al intérprete python.exe y al intérprete pythonw.exe. La primera se abre en Explorador de Windows, los dos últimos abren una ventana de consola.

Scripts de inicio

A medida que usa las ventanas interactivas en su flujo de trabajo diario, probablemente desarrolle funciones del asistente que usa con frecuencia. Por ejemplo, puede crear una función que abra un DataFrame en Excel y, después, guardar ese código como un script de inicio de manera que siempre esté disponible en la ventana interactiva.

Los scripts de inicio contienen código que la ventana interactiva carga y ejecuta automáticamente, como importaciones, definiciones de función y literalmente cualquier otra cosa. Hay dos maneras de hacer referencia a dichos scripts:

1. Cuando instala un entorno, Visual Studio crea una carpeta Documentos\Visual Studio <version>\Python Scripts\<environment>, donde <version> corresponde a la versión de Visual Studio (como 2017 o 2019) y <environment> coincide con el nombre del entorno. Puede navegar fácilmente a la carpeta específica del entorno con el comando Explorar scripts interactivos. Cuando inicie la ventana interactiva para ese entorno, se cargan y ejecutan los archivos de .py que se encuentran aquí en orden alfabético.

2. El control Scripts de la pestaña Herramientas>Opciones>Python>Ventanas interactivas (consulte Opciones de las ventanas interactivas) pretende especificar una carpeta adicional para los scripts de inicio que se cargan y ejecutan en todos los entornos. No obstante, esta característica no funciona actualmente.

Pestaña Configurar

Si está disponible, la pestaña Configurar contiene detalles como se describe en la tabla siguiente. Si esta pestaña no está presente, significa que Visual Studio administra todos los detalles automáticamente.

Campo	Descripción
Descripción	Nombre que se va a dar al entorno.
Prefix path (Ruta de acceso de prefijo)	Ubicación de la carpeta base del intérprete. Si rellena este valor y hace clic en Detección automática, Visual Studio intentará rellenar los demás campos automáticamente.
Interpreter path (Ruta de acceso del intérprete)	Ruta de acceso al ejecutable del intérprete, normalmente la ruta de acceso de prefijo seguida de python.exe.
Windowed interpreter (Intérprete en ventanas)	Ruta de acceso al ejecutable que no es de consola, normalmente la ruta de acceso de prefijo seguida de pythonw.exe.
Library path (Ruta de acceso a la biblioteca) (si está disponible)	Especifica la raíz de la biblioteca estándar, pero este valor se puede omitir si Visual Studio es capaz de solicitar una ruta de acceso más precisa desde el intérprete.
Versión de lenguaje	Se selecciona en el menú desplegable.
Arquitectura	Normalmente se detecta y rellena automáticamente; de lo contrario especifica 32 o 64 bits.
Path environment variable (Variable de entorno de ruta de acceso)	Variable de entorno que el intérprete usa para encontrar rutas de acceso de búsqueda. Visual Studio cambia el valor de la variable al iniciar Python para que contenga las rutas de búsqueda del proyecto. Normalmente, esta propiedad se debe establecer en PYTHONPATH, pero algunos intérpretes utilizan un valor diferente.

Pestaña Paquetes

También se etiqueta como "pip" en versiones anteriores

Administra los paquetes instalados en el entorno con pip (la pestaña Paquetes (PyPI) ) o conda (la pestaña Paquetes (Conda) para entornos en la versión 15.7 y posteriores de Visual Studio 2017). En esta pestaña también se pueden buscar e instalar paquetes nuevos, incluidas sus dependencias.

Los paquetes que ya están instalados aparecen con controles para actualizar (una flecha hacia arriba) y desinstalar (la X en un círculo) el paquete:

Especifique los filtros de un término de búsqueda en la lista de paquetes instalados, así como paquetes que pueden instalarse desde PyPI.

Como puede ver en la imagen anterior, los resultados de búsqueda muestran un número de paquetes que coinciden con el término de búsqueda; la primera entrada de la lista, sin embargo, es un comando para ejecutar pip install <name> directamente. Si se encuentra en la pestaña Paquetes (Conda), en su lugar verá conda install <name>:

En ambos casos, puede personalizar la instalación si agrega argumentos en el cuadro de búsqueda después del nombre del paquete. Cuando se incluyen argumentos, en los resultados de la búsqueda se muestra pip install o conda install seguido del contenido del cuadro de búsqueda:

Al instalar un paquete se crean subcarpetas dentro de la carpeta Lib del entorno en el sistema de archivos. Por ejemplo, si tiene instalado Python 3.6 en c:\Python36, los paquetes se instalan en c:\Python36\Lib; si tiene instalado Anaconda3 en c:\Program Files\Anaconda3, los paquetes se instalan en c:\Program Files\Anaconda3\Lib. En el caso de los entornos de Conda, los paquetes se instalan en la carpeta de ese entorno.

Concesión de privilegios de administrador para la instalación de paquetes

Al instalar paquetes en un entorno que está situado en un área protegida del sistema de archivos, como c:\Program Files\Anaconda3\Lib, Visual Studio debe ejecutar pip install con permisos elevados para permitirle que cree subcarpetas del paquete. Cuando se necesita la elevación de privilegios, Visual Studio muestra el mensaje Puede que se necesiten privilegios de administrador para instalar, actualizar o desinstalar paquetes para este entorno:

Elevar ahora concede privilegios administrativos a pip para una única operación, sujeto también a cualquier sistema operativo que solicite permisos. Al seleccionar Continuar sin privilegios de administrador se intenta instalar el paquete, pero pip produce un error al intentar crear carpetas con un resultado como error: no se pudo crear "C:\Archivos de programa\Anaconda3\Lib\site-packages\png.py": permiso denegado.

Al seleccionar Elevar siempre al instalar o desinstalar paquetes se impide que el cuadro de diálogo aparezca para el entorno en cuestión. Para que el cuadro de diálogo aparezca de nuevo, vaya a Herramientas>Opciones>Python>General y seleccione el botón Restablecer todos los cuadros de diálogo ocultos de manera permanente.

En esa misma pestaña de opciones, también puede seleccionar Ejecutar siempre pip como administrador para suprimir el cuadro de diálogo en todos los entornos. Vea Opciones: pestaña General.

Restricciones de seguridad con versiones anteriores de Python

Cuando se usa Python 2.6, 3.1 y 3.2, Visual Studio muestra la advertencia Debido a restricciones de seguridad, la instalación desde Internet podría no funcionar en esta versión de Python:

El motivo de la advertencia es que con estas versiones anteriores de Python, pip install no admite la Seguridad de la capa de transporte (TLS) 1.2, que es necesaria para descargar paquetes desde el proveedor, pypi.org. Las compilaciones de Python personalizadas pueden admitir TLS 1.2, en cuyo caso pip install podría funcionar.

Es posible descargar el get-pip.py apropiado para un paquete desde bootstrap.pypa.io, descargar manualmente un paquete desde pypi.org y, a continuación, instalar el paquete desde esa copia local.

Pero lo recomendable es actualizar a una versión reciente de Python, en cuyo caso no aparece la advertencia.

Vea también

• Creación y administración de entornos de Python en Visual Studio
• Selección de un intérprete para un proyecto
• Uso de requirements.txt para las dependencias
• Rutas de acceso de búsqueda