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.

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.

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.

🧪 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

Test

Comprueba tus conocimientos con un test sobre Python.

Test de Python

¿Qué es esto?

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

La hice en febrero de 2026 para facilitar el aprendizaje de mis alumnos. La idea es aprender desarrollo web practicando y que el proyecto siga creciendo con nuevos temas, tests y retos.

Está inspirada en MDN, W3Schools, CodePen, Manz y muchos otros sitios de documentación sobre desarrollo web. Quería combinar teoría útil, ejemplos ejecutables, retos y el sistema de tests que ya tenía en culTest. culTest

Si te gustó, si no te gustó o si quieres escribirme, puedes hacerlo en cristianeslava@gmail.com