Cómo crear un entorno virtual en Python y evitar errores de dependencias

Un entorno virtual de Python permite aislar las dependencias de un proyecto y evita que la instalación de una biblioteca cambie otros programas del ordenador. En esta guía aprenderás a crear un entorno con venv, activarlo, instalar paquetes y guardar las dependencias para que el proyecto pueda reproducirse en otro equipo.

Qué es un entorno virtual de Python

Un entorno virtual es una carpeta que contiene una instalación aislada de Python y sus paquetes. En lugar de instalar todo de forma global, cada proyecto tiene sus propias versiones. Esto resulta especialmente útil cuando dos aplicaciones necesitan versiones diferentes de la misma biblioteca.

Crear el entorno con venv

Abre una terminal dentro de la carpeta del proyecto y ejecuta:

python -m venv .venv

En algunos sistemas el comando puede ser python3. La carpeta .venv suele excluirse del repositorio porque se puede reconstruir a partir de la lista de dependencias.

Activar el entorno en cada sistema

En Windows PowerShell:

.venv\Scripts\Activate.ps1

En macOS y Linux:

source .venv/bin/activate

Cuando está activo, normalmente aparece (.venv) al principio de la línea de comandos. Comprueba la versión y la ruta que se están usando:

python --version
python -c "import sys; print(sys.executable)"

Instalar paquetes y guardar requirements.txt

Con el entorno activo, instala solo lo que el proyecto necesita:

python -m pip install --upgrade pip
pip install requests pytest
pip freeze > requirements.txt

El archivo requirements.txt permite documentar las versiones instaladas. Otra persona puede reconstruir el entorno con:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Errores frecuentes y cómo resolverlos

El comando python no existe

Prueba python3 y confirma que Python está instalado desde la página oficial de Python.

El entorno no se activa en PowerShell

El sistema puede bloquear scripts locales. Revisa la política de ejecución de tu usuario y utiliza únicamente instrucciones que entiendas. No descargues scripts de activación desde sitios desconocidos.

pip instala fuera del entorno

Usa python -m pip en lugar de llamar a pip directamente. Así te aseguras de que pip pertenece al intérprete activo.

Buenas prácticas para proyectos reales

• Añade .venv/ a .gitignore.
• Conserva requirements.txt actualizado.
• Documenta la versión mínima de Python.
• Separa dependencias de producción y de pruebas cuando el proyecto crezca.
• Lee la documentación oficial antes de instalar paquetes críticos.

Conclusión

Crear un entorno virtual es una de las primeras tareas que conviene automatizar en cualquier proyecto Python. Si quieres continuar aprendiendo, consulta también nuestra guía sobre cómo aprender Python desde cero y practica con un proyecto pequeño.

Fuentes oficiales

• Documentación de venv
• Guía de entornos virtuales y pip

Si quieres conocer otros artículos parecidos a Cómo crear un entorno virtual en Python y evitar errores de dependencias puedes visitar la categoría Lenguajes de Programación.