Creación y administración de entornos de Python en Visual Studio

Un entorno de Python es un contexto en el que se ejecuta código de Python e incluye entornos globales, virtuales y conda. Un entorno consta de un intérprete, una biblioteca (normalmente la biblioteca estándar de Python) y un conjunto de paquetes instalados. Estos componentes determinan conjuntamente construcciones de lenguaje válidas y sintaxis, funcionalidad del sistema operativo a la que puede acceder y paquetes que puede usar.

En Visual Studio en Windows, se usa la ventana Entornos de Python , como se describe en este artículo, para administrar entornos y seleccionar uno como valor predeterminado para los nuevos proyectos.

Puede obtener información sobre otros aspectos de los entornos en los siguientes artículos:

• Para cualquier proyecto determinado, puede seleccionar un entorno específico en lugar de usar el valor predeterminado.

• Para más información sobre cómo crear y usar entornos virtuales para proyectos de Python, consulte Uso de entornos virtuales.

• Si desea instalar paquetes en un entorno, consulte la referencia de pestaña Paquetes.

• Para instalar otro intérprete de Python, consulte Instalación de intérpretes de Python. En general, si descarga y ejecuta un instalador para una distribución principal de Python, Visual Studio detecta que la nueva instalación y el entorno aparecen en la ventana Entornos de Python y se pueden seleccionar para proyectos.

Nota:

Puede administrar entornos para código de Python que se abran como una carpeta seleccionando Abrir>de archivos>. La barra de herramientas de Python permite cambiar entre todos los entornos detectados y también agregar un nuevo entorno. La información del entorno se almacena en el archivo PythonSettings.json en la carpeta .vs del área de trabajo.

Prerrequisitos

• Una carga de trabajo de Python instalada

Si no está familiarizado con Python en Visual Studio, consulte los artículos siguientes para obtener información general:

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

Ventana de Entornos de Python

Los entornos que Visual Studio conoce se muestran en la ventana Entornos de Python . Para abrir la ventana, use uno de los métodos siguientes:

• Seleccione Ver> otrosentornos de Python de>.
• Haga clic con el botón derecho en el nodo Entornos de Python de un proyecto en el Explorador de soluciones y seleccione Ver todos los entornos de Python.

La ventana Entornos de Python aparece junto con el Explorador de soluciones en Visual Studio:

Visual Studio busca entornos globales instalados mediante el registro (después de PEP 514), junto con entornos virtuales y entornos de Conda. Si no ve un entorno esperado en la lista, consulte Identificación manual de un entorno existente.

Al seleccionar un entorno en la lista, Visual Studio muestra varias propiedades y comandos para ese entorno en la pestaña Información general de la ventana Entornos de Python , como la ubicación del intérprete. Cada uno de los comandos en la parte inferior de la pestaña Información general abre un símbolo del sistema con el intérprete en ejecución. Para obtener más información, consulte Referencia de la pestaña ventana Entornos de Python: Información general.

Use la lista desplegable en la lista de entornos para cambiar a diferentes pestañas, como Paquetes e IntelliSense. Estas pestañas también se describen en la referencia de pestañas de la ventana Entornos de Python.

La selección de un entorno no cambia su relación con ningún proyecto. El entorno predeterminado, que se muestra en negrita en la lista, es el que Usa Visual Studio para los nuevos proyectos. Para usar un entorno diferente con nuevos proyectos, use el comando Make this the default environment for new projects (Establecer este entorno predeterminado para los nuevos proyectos ). En el contexto de un proyecto, siempre puede seleccionar un entorno específico. Para obtener más información, vea Seleccionar un entorno para un proyecto.

A la derecha de cada entorno enumerado, es un control que abre una ventana interactiva para ese entorno.

Nota:

En Visual Studio 2017 15.5 y versiones anteriores, aparece otro control que actualiza la base de datos de IntelliSense para ese entorno. Para más información sobre la base de datos, consulte la referencia de la pestaña de la ventana Entornos de Python.

Sugerencia

Al expandir la ventana Entornos de Python lo suficientemente ancha, verá una vista más completa de los entornos con los que puede resultar más cómodo trabajar.

Nota:

Aunque Visual Studio respeta la opción system-site-packages, no proporciona una manera de cambiarla desde Visual Studio.

¿Qué pasa si no se muestran entornos?

Si no ve ningún entorno en la ventana Entornos de Python , significa que Visual Studio no pudo detectar las instalaciones de Python en ubicaciones estándar. Quizá haya instalado Visual Studio 2017 o posterior, pero desactive todas las opciones del intérprete en las opciones del instalador para la carga de trabajo de Python. Del mismo modo, es posible que haya instalado Visual Studio 2015 o versiones anteriores, pero no instaló manualmente un intérprete. Para más información, consulte Instalación de intérpretes de Python.

Si sabe que tiene un intérprete de Python en el equipo, pero Visual Studio (cualquier versión) no lo detectó, use el comando + Personalizado para especificar manualmente la ubicación del intérprete. Para obtener más información, consulte Identificación manual de un entorno existente.

Tipos de entornos

Visual Studio puede trabajar con entornos globales, virtuales y conda.

Entornos globales

Cada instalación de Python mantiene su propio entorno global. Por ejemplo, Python 2.7, Python 3.6, Python 3.7, Anaconda 4.4.0, etc. Para más información, consulte Instalación de intérpretes de Python.

Cada entorno se compone del intérprete de Python específico, su biblioteca estándar y un conjunto de paquetes preinstalados. También contiene cualquier otro paquete que instale mientras se activa el entorno. La instalación de un paquete en un entorno global hace que esté disponible para todos los proyectos que usan ese entorno. Si el entorno se encuentra en un área protegida del sistema de archivos (dentro de los archivos c:\program, por ejemplo), la instalación de paquetes requiere privilegios de administrador.

Los entornos globales están disponibles para todos los proyectos del equipo. En Visual Studio, se selecciona un entorno global como valor predeterminado, que se usa para todos los proyectos, a menos que elija específicamente otro para un proyecto. Para obtener más información, vea Seleccionar un entorno para un proyecto.

Entornos virtuales

Trabajar en un entorno global es una manera fácil de empezar. Con el tiempo, los entornos pueden estar desordenados con muchos paquetes diferentes instalados para diferentes proyectos. El desorden puede dificultar la prueba exhaustiva de la aplicación en un conjunto específico de paquetes con versiones conocidas. Pero este tipo de entorno es lo que se espera configurar en un servidor de compilación o en un servidor web. Los conflictos también pueden producirse cuando dos proyectos requieren paquetes incompatibles o versiones diferentes del mismo paquete.

Por estas razones, los desarrolladores suelen crear un entorno virtual para un proyecto. Un entorno virtual es una subcarpeta de un proyecto que contiene una copia de un intérprete específico. Si activa el entorno virtual, los paquetes que instale solo se instalan en la subcarpeta de ese entorno. Al ejecutar un programa de Python en el entorno virtual, puede estar seguro de que el programa se ejecuta solo en esos paquetes específicos.

Visual Studio proporciona compatibilidad directa para crear un entorno virtual para un proyecto. Si abre un proyecto que contiene un archivo requirements.txt , Visual Studio le pedirá que cree automáticamente un entorno virtual e instale esas dependencias. Verá el mismo comportamiento al crear un proyecto a partir de una plantilla que incluya requirements.txt archivo.

En cualquier momento dentro de un proyecto abierto, puede crear un nuevo entorno virtual. En el Explorador de soluciones, expanda el nodo del proyecto, haga clic con el botón derecho en Entornos de Python y elija Agregar entorno. En Agregar entorno, elija Entorno virtual. Para obtener más información, consulte Creación de un entorno virtual.

Visual Studio también proporciona un comando para generar un archivo requirements.txt a partir de un entorno virtual, lo que facilita la recreación del entorno en otros equipos. Para más información, consulte Uso de entornos virtuales.

Entornos de Conda

Puede crear un entorno de Conda utilizando la herramienta conda, o con la administración integrada de Conda en Visual Studio 2017, versión 15.7 y posteriores. Un entorno de Conda requiere Anaconda o Miniconda. Estas plataformas están disponibles a través del Instalador de Visual Studio. Para obtener más información, consulte Instalación de compatibilidad con Python en Visual Studio.

1. En la ventana Entornos de Python o en la barra de herramientas de Python, seleccione Agregar entorno para abrir el cuadro de diálogo Agregar entorno .

2. En el cuadro de diálogo Agregar entorno , seleccione la pestaña Entorno de Conda :

   

3. Configure los campos siguientes:

   Campo	Description
   Proyecto	Identifica el proyecto en el que se va a crear el entorno.
   Nombre	Proporciona el nombre del entorno de Conda.
   Adición de paquetes desde	Especifica cómo agregar paquetes al entorno de Conda. - Archivo de entorno: seleccione esta opción si tiene un archivo environment.yml que describe las dependencias. Escriba el nombre del archivo o busque (...) en la ubicación del archivo y seleccione el archivo. - Uno o varios nombres de paquete anaconda: seleccione esta opción si desea enumerar uno o varios paquetes de Python o versiones de Python. La lista de paquetes indica a Conda que cree un entorno de Python. Para instalar la versión más reciente de Python, use el python comando . Para instalar una versión específica, use el comando python=,major>.<minor> como en python=3.7. También puede usar el botón paquete para seleccionar versiones de Python y paquetes comunes en una serie de menús.
   Establecer como entorno actual	Activa el nuevo entorno en el proyecto seleccionado después de crear el entorno.
   Establecer como entorno predeterminado para los nuevos proyectos	Establece y activa automáticamente el entorno de Conda en los nuevos proyectos creados en Visual Studio. Esta opción es la misma que usar Establecer este como el entorno predeterminado para nuevos proyectos en la ventana de Entornos de Python.
   Ver en la ventana Entornos de Python	Especifica si se va a mostrar la ventana Entornos de Python después de crear el entorno.

   Importante

   Al crear un entorno de Conda, asegúrese de especificar al menos una versión de Python o un paquete de Python para asegurarse de que el entorno contiene un entorno de ejecución de Python. Puede usar un archivo environments.yml o la lista de paquetes. Si no proporciona esta especificación, Visual Studio omite el entorno. El entorno no aparece en ninguna parte de la ventana Entornos de Python , no se establece como el entorno actual de un proyecto y no está disponible como un entorno global.

   Si se crea un entorno de Conda sin una versión de Python, use el conda info comando para ver las ubicaciones de las carpetas del entorno de Conda. A continuación, puede eliminar manualmente la subcarpeta del entorno de esa ubicación.

4. Selecciona Crear.

Puede supervisar la creación del entorno de conda en la ventana Salida . Una vez completada la creación, la salida muestra algunas instrucciones de interfaz de línea de comandos (CLI), como conda activate env:

1. En Visual Studio, puede activar un entorno de conda para el proyecto de la misma manera que lo haría con cualquier otro entorno. Para obtener más información, vea Seleccionar un entorno para un proyecto.

2. Para instalar más paquetes en el entorno, use la pestaña Paquetes en la ventana Entornos de Python .

Nota:

Para obtener los mejores resultados con entornos de Conda, use conda 4.4.8 o posterior. Tenga en cuenta que las versiones de Conda son diferentes de las versiones de Anaconda. Puede instalar versiones adecuadas de Miniconda (Visual Studio 2019 y Visual Studio 2022) y Anaconda (Visual Studio 2017) a través del Instalador de Visual Studio.

Para ver la versión de Conda, donde se almacenan los entornos de Conda y otra información, ejecute el conda info comando en un símbolo del sistema de Anaconda (un símbolo del sistema donde Anaconda está en la ruta de acceso):

conda info

Las carpetas del entorno de Conda aparecen de la siguiente manera:

       envs directories : C:\Users\user\.conda\envs
                          c:\anaconda3\envs
                          C:\Users\user\AppData\Local\conda\conda\envs

Dado que los entornos de Conda no se almacenan con un proyecto, se comportan de forma similar a los entornos globales. Por ejemplo, la instalación de un nuevo paquete en un entorno de Conda hace que ese paquete esté disponible para todos los proyectos que usan el entorno.

Para Visual Studio 2017 versión 15.6 y versiones anteriores, puede usar entornos de Conda apuntando a ellos manualmente, tal como se describe en Identificación manual de un entorno existente.

Visual Studio 2017, versión 15.7 y versiones posteriores, detecta automáticamente los entornos de Conda y los muestra en la ventana Entornos de Python , tal como se describe en la sección siguiente.

Identificación manual de un entorno existente

Siga estos pasos para identificar un entorno instalado en una ubicación no estándar.

1. En la ventana Entornos de Python o en la barra de herramientas de Python, seleccione Agregar entorno para abrir el cuadro de diálogo Agregar entorno .

2. En el cuadro de diálogo Agregar entorno , en la pestaña Entorno existente , establezca el campo Entorno en <Personalizado>:

Después de seleccionar el <valor personalizado> , se agregan más campos al cuadro de diálogo.

3. Establezca el campo Ruta de prefijo en el directorio del intérprete. Para establecer el campo, navegue (...) hasta la ubicación de la ruta de acceso.

4. Después de seleccionar la ruta de acceso, se rellenan los campos restantes. Revise los valores y modifique según sea necesario. Cuando esté listo, seleccione Agregar.

También puede revisar y modificar los detalles del entorno en cualquier momento en la ventana Entornos de Python .

1. En la ventana Entornos de Python , seleccione el entorno y, a continuación, seleccione la pestaña Configurar .

2. Después de realizar cambios, seleccione el comando Aplicar .

También puede eliminar el entorno mediante el comando Eliminar. Para obtener más información, consulte la pestaña Configurar. Este comando no está disponible para entornos detectados automáticamente.

Corrección o eliminación de entornos no válidos

Si Visual Studio encuentra entradas del Registro para un entorno, pero la ruta de acceso al intérprete no es válida, la ventana Entornos de Python muestra el nombre del entorno en formato tachado, como se muestra en la siguiente imagen.

Para corregir un entorno que desea conservar, pruebe primero a usar el proceso de reparación del instalador del entorno. La mayoría de los instaladores incluyen una opción de reparación.

Modificación del registro para corregir un entorno

Si el entorno de Python no tiene una opción de reparación o desea quitar un entorno no válido, puede usar los pasos siguientes para modificar el registro directamente. Visual Studio actualiza automáticamente la ventana Entornos de Python al realizar cambios en el registro.

1. Ejecutar el ejecutable regedit.exe para abrir el editor del Registro.

2. Vaya a la carpeta de entorno que corresponde a la configuración:

   Versión de Python	Carpeta
   Versión de 64 bits	HKEY_LOCAL_MACHINE\SOFTWARE\Python o HKEY_CURRENT_USER\Software\Python
   Versión de 32 bits	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python
   IronPython	IronPython

3. Expanda la estructura del nodo de versión y distribución para su entorno:

   Distribución	Nodo
   CPython	PythonCore><Nodo de versión>
   Anaconda	ContinuumAnalytics><Nodo de versión>
   IronPython	<Nodo de versión>

4. Inspeccione los valores en el nodo InstallPath :

   

   • Si el entorno sigue existiendo en el equipo, cambie el valor de la entrada ExecutablePath a la ubicación correcta. Corrija también los valores de las entradas (Default) y WindowedExecutablePath , según sea necesario.
   • Si el entorno ya no existe en su computadora y desea eliminarlo de la ventana Entornos de Python, elimine el nodo padre del número de versión del nodo InstallPath. Puede ver un ejemplo de este nodo en la imagen anterior. En el ejemplo, este nodo es 3.6.

   Precaución

   La configuración no válida de la clave HKEY_CURRENT_USER\SOFTWARE\Python invalida la configuración de la clave HKEY_LOCAL_MACHINE\SOFTWARE\Python .

Eliminar o quitar un entorno de Python

Para quitar un proyecto de Python, vaya al entorno de Python en el Explorador de soluciones. Haga clic con el botón derecho en el entorno de Python que desea quitar y seleccione Quitar.

Si desea mantener el entorno de Python pero quitarlo del proyecto, seleccione Quitar. Si desea eliminar el entorno de forma permanente, seleccione Eliminar.

Contenido relacionado

• Instalación de intérpretes de Python
• Selección de un entorno de Python para un proyecto en Visual Studio
• Administración de paquetes de Python necesarios con requirements.txt
• Uso de carpetas de Python en rutas de búsqueda de Visual Studio
• Referencia de la ventana Entornos de Python