Cómo crear un entorno virtual de Python?

Publicado el lunes, 03 de febrero del 2025

Un entorno virtual en Python es un espacio de trabajo en el que puedes ejecutar código e instalar paquetes sin afectar la instalación global de Python.

En esta guía rápida, aprenderás los pasos para crear un entorno virtual en Windows, macOS y Linux (Debian/Ubuntu).

Conociendo los entornos virtuales de Python

Los entornos virtuales de Python te sirven para gestionar dependencias de manera independiente para cada uno de tus proyectos. Esto te evita conflictos entre diferentes versiones de bibliotecas.

En la práctica, un entorno virtual:

  • Crea una copia aislada de Python y pip dentro de un directorio específico.
  • Permite instalar paquetes sin interferir con otros proyectos o con el sistema operativo.
  • Facilita la replicación de entornos en distintos dispositivos o servidores.

Crear un entorno virtual Python en Windows

Los requisitos previos para crear un entorno virtual de Python en Windows son los siguientes:

  • Tener instalado Python.
  • Asegurarse de que python y pip funcionan correctamente.

Una vez que tu sistema cumple los requisitos previos, puedes crear un entorno virtual de Python siguiendo los pasos que a continuación se describen.

  1. Abrir símbolo del sistema (cmd.exe) o la aplicación PowerShell.

  2. Navegar a la carpeta donde deseas crear el entorno virtual:

PS> cd ruta\al\proyecto
  1. Crear el entorno virtual:
PS> py -m venv venv\
  1. Activar el entorno virtual:
PS> venv\Scripts\activate
(venv) PS>
  1. Desactivar el entorno y regresar al indicador (prompt) del sistema:
PS> deactivate

Crear un entorno virtual Python en macOS

En macOS, para crear un entorno virtual de Python, solo necesitas tener Python correctamente instalado en tu sistema. Una vez instalado, puedes seguir los siguientes pasos para crear un entorno virtual de Python:

  1. Abrir la Terminal.

  2. Navegar a la carpeta donde deseas crear el entorno virtual:

$ cd ruta/al/proyecto
  1. Crear el entorno virtual:
$ python3 -m venv venv
  1. Activar el entorno virtual:
$ source venv/bin/activate
(venv) $
  1. Desactivar el entorno y regresar al indicador del sistema:
$ deactivate

Crear un entorno virtual Python en Linux (Debian/Ubuntu)

Si tienes un sistema Linux basado en Debian o Ubuntu, entonces los requisitos son los siguientes:

  • Tener instalado Python
  • Tener el módulo venv

En Ubuntu, el módulo venv no viene instalado por defecto. Si ese es tu sistema, entonces puedes instalar venv con el siguiente comando:

$ sudo apt update && sudo apt install python3-venv

Luego de cumplir con los requisitos iniciales, puedes crear un entorno virtual Python siguiendo los pasos a continuación:

  1. Abrir la terminal o línea de comandos.

  2. Navegar a la carpeta del proyecto:

$ cd ruta/al/proyecto
  1. Crear el entorno virtual:
$ python3 -m venv venv
  1. Activar el entorno virtual:
$ source venv/bin/activate
(venv) $
  1. Desactivar el entorno y regresar al indicador del sistema:
$ deactivate

Resumiendo

En Python, las buenas prácticas recomiendan el empleo de entornos virtuales dedicados para cada uno de tus proyectos. Siguiendo los pasos de esta guía, puedes crear y activar entornos virtuales de Python de manera eficiente en el sistema operativo que estés usando en tu computadora.