Creación y gestión de entornos virtuales con venv en Python

Domina la creación de entornos virtuales en Python con venv, pip y Visual Studio Code. Aprende a verificar tu instalación, crear y activar un entorno, instalar paquetes desde PyPI y fijar versiones con requirements.txt para compartir un proyecto de forma segura.

¿Cómo verificar Python y ubicar el ejecutable con which?

Antes de crear un entorno virtual, confirma que Python está instalado y localiza el ejecutable correcto. Verlo es clave cuando hay múltiples versiones o un alias a python3.

¿Qué comandos confirman la instalación?

Usa estos comandos en la terminal para verificar versión y ruta del ejecutable.

python --version
which python
which python3

• Confirma la versión de Python instalada.
• Identifica si python apunta a python3 como alias.
• Comprueba el ejecutable real (por ejemplo, instalado con Homebrew en macOS).

¿Por qué importa el path cuando hay varios ejecutables?

Porque al activar un entorno virtual, el path del ejecutable cambia para apuntar al Python del entorno. Así evitas ejecutar paquetes del sistema por error. Verifica con which python3 antes y después de activar el entorno para notar la diferencia.

¿Cómo crear y activar un entorno virtual con venv?

Crear un entorno con -m venv aísla dependencias, manteniendo tu proyecto limpio y reproducible. Al ejecutarlo, se genera una carpeta con scripts y configuraciones propias del entorno.

¿Qué crea python -m venv y qué hay en las carpetas?

Ejecuta el módulo venv y nómbralo, por ejemplo newsemv.

python -m venv newsemv

Tras crearlo, verás:

• bin/: ejecutables de Python, ejecutables de pip y scripts de activación para Linux y Windows.
• include/: cabeceras de Python usadas durante instalaciones con pip.
• lib/: librerías instaladas dentro del entorno; comienza vacío con solo pip.
• Archivo de configuración: ruta del home y versión usados al ejecutar Python.

Idea clave: cada entorno nuevo inicia sin paquetes, listo para instalar solo lo necesario.

¿Cómo activar y desactivar el entorno virtual?

Activa y verifica que cambió el ejecutable a la ruta del entorno. Luego desactiva cuando termines.

# activar (Linux/macOS)
source newsemv/bin/activate

# verificar rutas
which python
which python3

# desactivar
deactivate

• Al activar, which muestra el path dentro de newsemv.
• Al desactivar, which vuelve al ejecutable global (ejemplo: Homebrew).
• Mantén claridad sobre qué entorno está activo para evitar errores.

¿Cómo ayuda Visual Studio Code con entornos?

La extensión de Python y el panel de Python Environments permiten seleccionar el entorno, ver dependencias e incluso activar automáticamente el entorno al abrir la terminal integrada. Útil para no equivocarte de intérprete.

¿Cómo instalar dependencias desde PyPI y fijar versiones con requirements.txt?

Instala paquetes desde PyPI, lista dependencias con pip y fija versiones con requirements.txt. Así otras personas pueden replicar tu entorno sin sorpresas.

¿Cómo instalar y listar paquetes con pip?

Busca en PyPI y copia el comando de instalación. Ejemplo con ruff (formateador de código):

pip install ruff

# verificar paquetes instalados
override
pip list

• Instala desde PyPI la versión disponible.
• Visualiza los paquetes presentes en tu entorno virtual.

¿Cómo compartir dependencias con requirements.txt?

Usa pip freeze para capturar la versión exacta instalada y compártela en un archivo.

# generar el archivo con versiones fijadas
pip freeze > requirements.txt

# instalar desde el archivo
pip install -r requirements.txt

# desinstalar un paquete específico
pip uninstall ruff -y

• pip freeze exporta en formato paquete==versión para asegurar reproducibilidad.
• pip install -r instala exactamente las versiones definidas.
• Puedes reinstalar tras desinstalar para validar el flujo.

¿Qué buenas prácticas debes aplicar?

• No subas la carpeta del entorno virtual al repo. Agrega el nombre del entorno a .gitignore.
• Mantén versiones fijadas en requirements.txt para evitar roturas por actualizaciones.
• Considera usar python-dotenv para gestionar tu API key fuera del código y protegerla.

¿Quieres que revisemos tu flujo con venv y requirements.txt o que comentemos alternativas con pip-tools o uv? Comparte tu experiencia y dudas en los comentarios.