{}
Aprende diseño y desarrollo web
Cursos gratuitos interactivos

Entornos virtuales y pip: aislar dependencias sin romper proyectos

Domina `venv` y `pip` para crear entornos reproducibles, evitar conflictos de versiones y mantener proyectos Python profesionales.

Cada proyecto Python debe tener su propio entorno virtual para evitar conflictos entre dependencias.

`venv` crea una instalación local de Python y pip aislada del sistema global.

`pip` instala paquetes en el entorno activo; si no activas el entorno, instalas fuera y generas errores difíciles de rastrear.

Versionar dependencias (`requirements.txt`) permite reproducir el entorno en otro equipo o en CI.

  • Sin aislamiento de entorno, tarde o temprano aparecerán choques de versiones.
  • `python -m venv .venv` crea un entorno local en la carpeta del proyecto.
  • Tras activarlo, los comandos `python` y `pip` apuntan al entorno aislado.
  • Conviene usar nombre `.venv` por convención para facilitar reconocimiento por herramientas y editores.
  • No basta instalar; debes dejar trazabilidad de versiones.

1) Crear y activar un entorno virtual

Sin aislamiento de entorno, tarde o temprano aparecerán choques de versiones.

`python -m venv .venv` crea un entorno local en la carpeta del proyecto.

Tras activarlo, los comandos `python` y `pip` apuntan al entorno aislado.

Conviene usar nombre `.venv` por convención para facilitar reconocimiento por herramientas y editores.

2) Instalar y fijar dependencias con pip

No basta instalar; debes dejar trazabilidad de versiones.

Usa `pip install paquete==version` cuando quieras estabilidad exacta.

Guarda estado del entorno con `pip freeze > requirements.txt` para replicarlo en CI o despliegue.

Actualiza con criterio: cambios de versión mayor pueden romper API y tests existentes.

3) Verificar que realmente estás en el entorno correcto

Muchos errores de instalación vienen de usar el `python` equivocado.

Con `sys.executable` puedes confirmar qué binario de Python se está usando realmente.

`pip --version` también indica ruta asociada; debe apuntar al `.venv` del proyecto.

Si VSCode ejecuta otro intérprete, corrígelo en `Python: Select Interpreter`.

  • Activa entorno antes de instalar paquetes.
  • Verifica ejecutable real con `sys.executable`.
  • Versiona dependencias del proyecto.
  • Evita instalaciones globales para apps de negocio.
Python
16

Entornos virtuales y pip: aislar dependencias sin romper proyectos

Domina `venv` y `pip` para crear entornos reproducibles, evitar conflictos de versiones y mantener proyectos Python profesionales.

¿Cuánto sabes de Python?

Código del tema: python -m venv .venv && pip install -r requirements.txt

📘 Teoría

1) Crear y activar un entorno virtual

Sin aislamiento de entorno, tarde o temprano aparecerán choques de versiones.

1

`python -m venv .venv` crea un entorno local en la carpeta del proyecto.

2

Tras activarlo, los comandos `python` y `pip` apuntan al entorno aislado.

3

Conviene usar nombre `.venv` por convención para facilitar reconocimiento por herramientas y editores.

Creación/activación en distintos sistemas
# Crear entorno
python -m venv .venv

# Activar (Windows cmd)
.venv\Scripts\activate

# Activar (PowerShell)
.venv\Scripts\Activate.ps1

# Activar (Linux/macOS)
source .venv/bin/activate

2) Instalar y fijar dependencias con pip

No basta instalar; debes dejar trazabilidad de versiones.

Usa `pip install paquete==version` cuando quieras estabilidad exacta.

Guarda estado del entorno con `pip freeze > requirements.txt` para replicarlo en CI o despliegue.

Actualiza con criterio: cambios de versión mayor pueden romper API y tests existentes.

1

Instalación controlada

Versiones explícitas para reproducibilidad.

2

Exportar e importar entorno

Reproducir dependencias en otro equipo.

3) Verificar que realmente estás en el entorno correcto

Muchos errores de instalación vienen de usar el `python` equivocado.

Con `sys.executable` puedes confirmar qué binario de Python se está usando realmente.

`pip --version` también indica ruta asociada; debe apuntar al `.venv` del proyecto.

Si VSCode ejecuta otro intérprete, corrígelo en `Python: Select Interpreter`.

  • Activa entorno antes de instalar paquetes.
  • Verifica ejecutable real con `sys.executable`.
  • Versiona dependencias del proyecto.
  • Evita instalaciones globales para apps de negocio.
Auditoría rápida del intérprete
import sys

print('python:', sys.executable)
print('version:', sys.version.split()[0])

🧪 Aprende probando

Ejemplo Ejemplo: generar requirements desde una lista de dependencias Simula un flujo de proyecto guardando dependencias mínimas en archivo estándar.
⌄

🏁 Retos

Reto Reto: completa comando de creación de entorno Escribe el módulo correcto para crear un entorno virtual local.
⌄

🧰 Recursos

Enlaces útiles

venv pip User Guide Python Packaging User Guide
Test

Comprueba tus conocimientos con un test sobre Python.

Test de Python
Recursos del curso 25
📘 Glosario 🎬 Vídeos 🔗 Enlaces
‹
Lección 15
Dataclasses y tipado en Python: modelos claros y mantenibles
Lección 17
Testing con Pytest: validar comportamiento y prevenir regresiones
›

¿Qué es esto?

Soy Cristian Eslava y a veces hago webs para procrastinar yo y vosotros 😉.

Esta la hice en febrero de 2026 para facilitar el aprendizaje de mis alumnxs. Aprender desarrollo web practicando. La idea es que crezca semanalmente con nuevos temas, tests y retos.

Inspirado en MDN, en W3Schools, en Codepen, en el crack de Manz y en mil sitios de documentación sobre desarrollo web. Quería aportar además de bloques teóricos con ejemplos, la gamificación de los retos y el sistema de test que ya tenía en culTest .

Si te gustó, si no te gustó, si quieres saludarme, o invitarme a 🍻 no dudes en escribirme en cristianeslava@gmail.com .