Gestión visual de entornos Python directamente desde Visual Studio Code

Microsoft ha lanzado su extensión Python Environments extension para Visual Studio Code , una herramienta diseñada para unificar la gestión de intérpretes y paquetes del popular lenguaje de programación. Aunque ya llevaba un año en preview, ahora tenemos ya disponible la versión definitiva.

La herramienta en preview tenía una valoración muy baja, pero se espera que esta versión final haya corregido todas las quejas que manifestaron los usuarios durante el periodo de pruebas anterior.

Python Environments trata de solucionar un problema que seguro que te suena si trabajas con este lenguaje. Sin ella, los desarrolladores tenían que pelearse con diferentes herramientas externas como conda, poetry, venv... que no siempre se comunicaban bien entre sí, generando errores de rutas y configuraciones locales difíciles de compartir.

Esta actualización busca que el entorno de trabajo con Python sea portátil y automático, eliminando las fricciones técnicas para que te centres solo en el código.

Lo más relevante de esta nueva herramienta es lo siguiente:

• Compatibilidad total: detecta automáticamente entornos creados con venv, conda, pyenv, poetry y pipenv, gracias a un motor de búsqueda ultra rápido escrito en Rust.

• Creación rápida de entornos:

  • Quick Create (el botón + en gestores de entornos) crea al instante un entorno con el gestor de entornos por defecto, la última versión de Python y las dependencias detectadas en requirements.txt o pyproject.toml
  • Custom Create (en el menú Python > Create Environment de la paleta de comandos) permite elegir gestor de entornos, versión de Python, nombre del entorno y qué archivos de dependencias instalar.

• Velocidad extrema con uv: si utilizas uv, el gestor de paquetes Python de última generación, la creación de entornos y la instalación de librerías es casi instantánea. uv es el gestor de paquetes que utilizamos y explicamos en nuestro Programa Experto de Machine Learning para Python.

• Proyectos de Python: ahora puedes asignar un entorno específico para una carpeta concreta. Esto es muy interesante al trabajar con monorepos (proyectos normalmente gigantes, con muchas subcarpetas) para que cada parte use su propia versión de Python sin conflictos.

• Configuración portátil: al guardar el tipo de gestor y no la ruta absoluta en el archivo settings.json, puedes pasarle el proyecto a un compañero (o sincronizarlo automáticamente a otro de tus equipos) y le funcionará a la primera, aunque use un sistema operativo distinto.

• Test multiproyecto: la extensión ahora utiliza la API de entornos de Python para soportar pruebas multiproyecto de modo que cada proyecto tenga su propia carpeta raíz de test, su propio intérprete y su propia configuración de descubrimiento de pruebas. Esto evita la contaminación cruzada entre servicios y garantiza que cada proyecto use el entorno correcto. Puedes conocer los detalles en la guía de Pruebas multiproyecto de la extensión de entornos de Python.

• Gestión de paquetes integrada: desde la propia vista puedes buscar e instalar paquetes, desinstalarlos o instalarlos desde requirements.txt, pyproject.toml o environment.yml. La extensión selecciona automáticamente el gestor correcto para cada tipo de entorno (pip para venv, conda para entornos conda, o pip de uv cuando usamos este gestor).

• Activación inteligente de la terminal: el entorno se activa antes de que escribas el primer comando, evitando que ejecutes scripts con la versión de Python incorrecta por error.

Además de la gestión técnica, la extensión incluye funciones de scaffolding, que te permiten crear la estructura de un proyecto (carpetas, archivos de test, configuración...) desde plantillas predefinidas.

También introduce el soporte nativo para archivos .env, permitiendo cargar variables de entorno (como claves de API o contraseñas de bases de datos) de forma segura y automática al abrir la terminal.

En resumen

Esta actualización supone el fin de la "fragmentación" en el ecosistema de Python dentro de VS Code. Al estandarizar la forma en la que el editor interactúa con los diferentes gestores, Microsoft pretende conseguir que la configuración del entorno ya no sea una barrera de entrada para los que están aprendiendo Python, ni una pérdida de tiempo para los profesionales.

Sin embargo, todo este tipo de automatizaciones plantean un debate interesante entre la comodidad y la pérdida progresiva de conocimientos sobre las herramientas. ¿Estamos dejando de entender cómo funciona nuestro sistema por culpa de la excesiva simplificación? Gracias a ella se nos facilita la vida mucho a todos, pero los que empiezan a aprender ya con estas facilidades, ¿serían capaces de solventar un problema cuando les falte o cuando tengan que usar otro entorno sin estas facilidades?

Aunque herramientas como uv y esta nueva extensión nos hacen más productivos, delegar toda la gestión del PATH y sobre todo de las dependencias a una "caja negra" de Microsoft podría pasar factura cuando algo falle y no sepamos ni por dónde empezar a buscar el error.

La eficiencia es fantástica, pero en formación siempre decimos que la magia es el enemigo del aprendizaje a fondo.