Cuando empiezas a desarrollar en Python, es tentador instalar todas las librerías directamente en tu sistema operativo usando un simple pip install. Sin embargo, a medida que tus proyectos crecen, esta práctica puede convertirse en una pesadilla de compatibilidad. ¿Qué pasa si el “Proyecto A” necesita Django 3.0, pero el “Proyecto B” requiere Django 4.0?
Aquí es donde entran al rescate los entornos virtuales. Un entorno virtual es un espacio aislado donde puedes instalar paquetes y dependencias específicas para un proyecto sin afectar al resto del sistema.
A continuación, aprenderás cómo crear, activar y gestionar estos entornos en Windows, macOS y Linux.
Requisitos Previos
Antes de empezar, necesitas tener Python instalado en tu equipo. Puedes verificar si ya lo tienes abriendo tu terminal o línea de comandos y ejecutando:
Bash
python --version
# o en algunos sistemas:
python3 --version
Asegúrate de tener la versión 3.3 o superior, ya que incluyen el módulo venv por defecto, que es la herramienta oficial y recomendada para crear entornos virtuales.
Creando el Entorno Virtual
El primer paso es navegar desde tu terminal hasta la carpeta raíz de tu proyecto. Una vez allí, ejecuta el comando para crear el entorno. La convención general es nombrar a la carpeta del entorno como venv, env o .venv.
Para Windows:
DOS
python -m venv venv
Para macOS y Linux:
Bash
usuario@pc:~/mi-proyecto$ python3 -m venv venv
Al ejecutar esto, notarás que se crea una nueva carpeta llamada venv en tu proyecto. Esta carpeta contiene una copia del intérprete de Python y un espacio limpio para instalar tus paquetes.
Activando el Entorno Virtual
Crear el entorno no es suficiente; debes “encenderlo” para que tu terminal sepa que debe usar el Python y las librerías aisladas de esa carpeta, y no los globales del sistema. El comando de activación varía según tu sistema operativo.
En Windows
Si usas el Símbolo del sistema (cmd):
DOS
venv\Scripts\activate.bat
Si usas PowerShell:
PowerShell
venv\Scripts\Activate.ps1
(Nota: Si PowerShell te arroja un error de permisos, es posible que necesites ejecutar Set-ExecutionPolicy Unrestricted -Scope CurrentUser primero).
En macOS y Linux
En sistemas basados en Unix, la activación se hace mediante el comando source:
Bash
source venv/bin/activate
¿Cómo sé que funcionó?
Sabrás que el entorno está activo porque el nombre de tu entorno aparecerá entre paréntesis al principio de la línea en tu terminal, algo así:
(venv) usuario@pc:~/mi-proyecto$ o (venv) C:\Ruta\Al\Proyecto>.
Instalando Paquetes
Una vez que el entorno está activado, cualquier paquete que instales se quedará atrapado dentro de este proyecto. Puedes probar instalando la librería requests:
Bash
pip install requests
Si quieres ver qué paquetes tienes instalados en este entorno específico, simplemente ejecuta:
Bash
pip freeze
Este comando es sumamente útil para exportar tus dependencias a un archivo requirements.txt cuando quieras compartir tu código.
Desactivando el Entorno
Cuando termines de trabajar en tu proyecto o necesites cambiar a otro distinto, debes salir del entorno virtual. Sin importar si estás en Windows, Mac o Linux, el comando es exactamente el mismo:
Bash
deactivate
Al ejecutarlo, los paréntesis desaparecerán de tu terminal y volverás a usar la versión global de Python de tu sistema operativo.
Acostumbrarte a usar entornos virtuales es uno de los mejores hábitos que puedes adoptar como desarrollador backend o de scripts en Python. Te ahorrará horas de dolores de cabeza intentando resolver conflictos de versiones y mantendrá tu sistema operativo limpio y organizado. ¡Crea un entorno por cada proyecto y mantén tu código a salvo!