¿Por qué y cómo se usan los entornos virtuales?

Question

Accepted Answer

Un **entorno virtual** es un entorno de Python aislado con sus propios paquetes instalados, separado del Python del sistema y de otros proyectos. Resuelve los **conflictos de dependencias** — distintos proyectos pueden usar versiones diferentes (incluso incompatibles) del mismo paquete.

## El problema que resuelve

```text
Project A needs Django 3.2
Project B needs Django 4.2
→ Installing globally, they CONFLICT — you can't have both versions system-wide.
Virtual environments give each project its OWN isolated set of packages.
```

Sin aislamiento, instalar paquetes globalmente provoca choques de versiones entre proyectos y puede romper herramientas del sistema que dependen de versiones específicas.

## Crear y usar uno (venv integrado)

```bash
# 1. create a virtual environment (a folder named .venv)
python -m venv .venv

# 2. ACTIVATE it (shell-specific)
source .venv/bin/activate      # macOS/Linux
.venv\Scripts\activate         # Windows

# 3. now pip installs go INTO this env, isolated from the system
pip install django requests

# 4. when done
deactivate
```

Una vez activado, `python` y `pip` se refieren a las copias aisladas del entorno — los paquetes se instalan solo ahí, no a nivel del sistema.

## Capturar y reproducir dependencias

```bash
pip freeze > requirements.txt       # record exact installed versions
pip install -r requirements.txt     # recreate the env elsewhere (teammate, CI, prod)
```

Un `requirements.txt` hace que el entorno sea **reproducible** — cualquiera puede recrear exactamente las mismas dependencias, evitando los problemas de "funciona en mi máquina".

## Herramientas modernas

```text
venv + pip      → built-in, standard, widely used
poetry          → dependency management + lockfile + packaging (popular)
pipenv          → combines pip + venv with a lockfile
uv / pdm        → newer, faster tools
conda           → common in data science (manages Python versions + non-Python deps too)
```

Las herramientas más nuevas (poetry, uv) añaden lockfiles y mejor resolución de dependencias, pero el concepto central — entornos aislados por proyecto — es el mismo.

## Siempre excluye el entorno del control de versiones

```text
# .gitignore
.venv/        ← don't commit the environment; commit requirements.txt/lockfile instead
```

## Por qué es importante

Los entornos virtuales son una práctica esencial y estándar para cualquier proyecto de Python — previenen conflictos de dependencias entre proyectos y entre los proyectos y el Python del sistema, y (con `requirements.txt`/lockfiles) hacen que los entornos sean reproducibles entre máquinas, compañeros de equipo, CI y producción.

Omitirlos lleva a choques de versiones, herramientas del sistema rotas y configuraciones irreproducibles.

Entender cómo crear, activar y capturar dependencias — y el panorama de herramientas modernas (poetry, uv) — es fundamental para el desarrollo profesional en Python y una expectativa básica en cualquier proyecto real.