Entornos virtuales de Python con venv: qué son y cómo usarlos

Qué es un entorno virtual de Python, por qué usarlo en cada proyecto y cómo crearlo, activarlo y gestionarlo con venv en Windows y Linux.

Entornos virtuales de Python con venv: qué son y cómo usarlos

En cuanto empiezas a usar Python en serio, te encuentras con un problema: cada proyecto necesita sus propias bibliotecas, a veces en versiones distintas. Un script quiere una versión concreta de una biblioteca, otro proyecto quiere una más reciente, y instalarlo todo en el mismo sitio acaba provocando, tarde o temprano, conflictos difíciles de entender.

La solución se llama entorno virtual. En esta guía vemos qué es, por qué conviene usarlo siempre y cómo gestionarlo con venv, la herramienta incluida en Python, tanto en Windows como en Linux.

Qué es un entorno virtual

Un entorno virtual es una carpeta que contiene una copia aislada de Python con sus propias bibliotecas. Cuando el entorno está activo, todo lo que instalas acaba ahí dentro, y no en el Python general del ordenador.

Puedes imaginarlo como una caja de herramientas dedicada a un único trabajo: cada proyecto tiene la suya, con las herramientas que necesita, y las cajas no se mezclan.

Las ventajas concretas son tres:

  • Sin conflictos: dos proyectos pueden usar versiones distintas de la misma biblioteca.
  • El sistema se mantiene limpio: en Linux, en particular, no corres el riesgo de dañar el Python que usa el sistema operativo.
  • El proyecto es reproducible: puedes recrear el mismo entorno en otro ordenador o en un servidor con un solo comando.

Antes de empezar

Necesitas tener Python ya instalado. En Ubuntu y Debian asegúrate también de tener el módulo venv, que no siempre está presente:

sudo apt install python3-venv

En Windows, si instalaste Python con el Python Install Manager, venv ya está incluido.

Crear un entorno virtual

Abre el terminal en la carpeta de tu proyecto y escribe:

# Windows
python -m venv .venv

# Linux y macOS
python3 -m venv .venv

El comando crea una carpeta llamada .venv con todo lo necesario. El nombre es una convención muy extendida: el punto inicial la hace «oculta» en Linux y la mayoría de los editores la reconocen automáticamente. Puedes llamarla como prefieras, pero .venv es la opción más cómoda.

En Windows, si tienes varias versiones de Python instaladas, puedes elegir con cuál crear el entorno:

py -V:3.14 -m venv .venv

El entorno usará siempre la versión con la que se creó.

Activar el entorno

Crear el entorno no basta: hay que activarlo cada vez que abres un terminal nuevo para trabajar en el proyecto. El comando cambia según el sistema:

# Windows, símbolo del sistema
.venv\Scripts\activate

# Windows, PowerShell
.venv\Scripts\Activate.ps1

# Linux y macOS
source .venv/bin/activate

Cuando el entorno está activo, su nombre aparece entre paréntesis al principio de la línea del terminal, por ejemplo (.venv). Es la señal de que estás trabajando dentro del entorno.

Si PowerShell bloquea el script de activación con un error sobre las directivas de ejecución, permite la ejecución de scripts locales para tu usuario con este comando, que solo tienes que ejecutar una vez:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Instalar bibliotecas

Con el entorno activo, las bibliotecas se instalan con pip, el gestor de paquetes de Python:

python -m pip install requests

¿Por qué python -m pip y no simplemente pip? Porque así tienes la certeza de que pip instala la biblioteca justo en el Python que estás usando. Con el comando pip a secas, si el entorno no está activo o hay varias versiones instaladas, la biblioteca podría acabar en el sitio equivocado. Es un pequeño hábito que evita muchos problemas.

Para ver las bibliotecas instaladas en el entorno:

python -m pip list

Guardar y recrear las dependencias con requirements.txt

Las bibliotecas que usa un proyecto se llaman dependencias. Para guardar su lista, con las versiones exactas, se usa un archivo llamado requirements.txt:

python -m pip freeze > requirements.txt

En otro ordenador, o en el servidor, basta con crear un entorno virtual nuevo, activarlo e instalarlo todo con un solo comando:

python -m pip install -r requirements.txt

El archivo requirements.txt debe conservarse junto con el código del proyecto. La carpeta .venv, en cambio, no debe copiarse ni añadirse a Git: contiene rutas ligadas a tu ordenador y se recrea en pocos segundos. Si usas Git, añade esta línea al archivo .gitignore:

.venv/

Desactivar y eliminar un entorno

Para salir del entorno virtual basta con escribir:

deactivate

Para eliminarlo por completo, borra simplemente la carpeta .venv. No hay nada que desinstalar: todo lo que contenía estaba ahí dentro.

Esto también es útil cuando quieres cambiar la versión de Python de un proyecto: elimina la carpeta, recrea el entorno con la nueva versión y vuelve a instalar las dependencias desde requirements.txt.

Usar el entorno con Visual Studio Code

Si usas Visual Studio Code con la extensión de Python, el editor suele reconocer por sí solo la carpeta .venv. Si no ocurre, abre la paleta de comandos con Ctrl+Shift+P, busca Python: Select Interpreter y elige el intérprete que está dentro de .venv. A partir de ese momento, también el terminal integrado activará el entorno automáticamente.

Errores comunes y soluciones

  • «ModuleNotFoundError: No module named …»: casi siempre el entorno no está activo, o la biblioteca se instaló en otro Python. Activa el entorno y vuelve a instalar la biblioteca con python -m pip install.
  • «error: externally-managed-environment» en Linux: estás intentando instalar una biblioteca en el Python del sistema. Crea y activa un entorno virtual y repite la instalación dentro de él.
  • «The virtual environment was not created successfully because ensurepip is not available» en Ubuntu o Debian: falta el paquete python3-venv. Instálalo con sudo apt install python3-venv, elimina la carpeta .venv incompleta y vuelve a crear el entorno.
  • El entorno deja de funcionar después de mover o renombrar la carpeta del proyecto: los entornos virtuales contienen rutas absolutas y no admiten traslados. Elimínalo y vuelve a crearlo.
  • Error «Microsoft Visual C++ 14.0 or greater is required» al instalar una biblioteca: normalmente el entorno se creó con una versión de Python demasiado reciente para esa biblioteca. Hemos dedicado un artículo a este error.

Un vistazo a las herramientas alternativas

Además de venv existen herramientas más completas, como uv o Poetry, que gestionan de una vez entornos, dependencias y versiones de Python. Son muy apreciadas en los proyectos más grandes. Para empezar, sin embargo, venv es la mejor opción: ya viene incluido en Python, funciona en todas partes y los conceptos que has aprendido aquí también valen para las demás herramientas.

Resumen

El flujo de trabajo de cualquier proyecto Python se reduce a unos pocos comandos:

  • Una vez: python -m venv .venv en la carpeta del proyecto.
  • Cada vez que trabajas en el proyecto: activa el entorno.
  • Para añadir bibliotecas: python -m pip install nombre y después actualiza requirements.txt.
  • En otro ordenador: crea el entorno, actívalo y ejecuta python -m pip install -r requirements.txt.

Fuentes oficiales

Compartir

¿Cuál es tu reacción?

Me gusta Me gusta 0
No me gusta No me gusta 0
Me encanta Me encanta 0
Divertido Divertido 0
Enfadado Enfadado 0
Triste Triste 0
¡Vaya! ¡Vaya! 0