El requisito indispensable para poder trabajar con Python es que tengas instalado el intérprete correctamente. En esta guía vamos a instalarlo, comprobar que todo funcione, crear nuestro primer entorno virtual, activarlo, instalar módulos dentro de él y finalmente desactivarlo.
Sigue esta guía escrita si nunca antes has configurado un entorno virtual en Python, o bien hazlo con este vídeo:
1. Instalar el intérprete de Python
- Busca Python en tu navegador y accede a la página oficial: python.org.
- Dirígete a la sección de Downloads (Descargas) y descarga la última versión disponible para tu sistema operativo.
- Ejecuta el instalador.
⚠️ No te olvides de activar la opción “Add Python to PATH” (Añadir Python al PATH) antes de continuar con la instalación. Esto es lo que te permitirá ejecutar Python desde cualquier lugar del sistema de archivos, sin importar en qué carpeta te encuentres.
2. Comprobar que la instalación fue correcta
Una vez instalado, hay que comprobarlo. Para abrir la consola en Windows tienes dos opciones:
- Pulsar la combinación de teclas Windows + R, escribir
cmdy pulsar Enter. - O ir a Inicio y buscar
cmdo Símbolo del sistema.
Ya dentro de la consola, escribe:
python --version
Deberías ver algo como:
Python x.x.x
Comprobar pip
También tenemos que comprobar que esté correctamente instalado pip (Package Installer for Python), que es el gestor con el que instalaremos módulos:
pip --version
Deberías ver la versión, por ejemplo pip x.x.x.
Con esto ya es suficiente para poder trabajar. Adicionalmente, puedes ejecutar:
pip list
para ver todos los módulos que tienes instalados de manera global en tu sistema.
3. Comprobar (o instalar) virtualenv
Entre esos módulos globales necesitamos tener virtualenv, que es el que nos permitirá crear entornos virtuales. Búscalo en la lista que devuelve pip list (por ejemplo, virtualenv 20.2.2).
Si no aparece, instálalo con:
pip install virtualenv
Con este módulo vamos a poder crear un entorno virtual y comenzar a trabajar dentro de él, instalando todos los módulos de Python que necesitemos para nuestro proyecto.
4. Crear la carpeta del proyecto
Cierra la consola. En el escritorio, haz clic derecho → Nuevo → Carpeta y llámala fundamentos (o el nombre que prefieras para tu proyecto).
Dentro de esta carpeta es donde vamos a crear nuestro primer entorno virtual.
5. Abrir una consola dentro de esa carpeta
Hay varias formas de situar la consola dentro de la carpeta del proyecto:
Opción A — PowerShell directo:
Entra a la carpeta fundamentos, mantén pulsada la tecla Shift, haz clic derecho en un espacio vacío y elige “Abrir la ventana de PowerShell aquí”.
Opción B — Símbolo del sistema con cd:
Abre una consola normal y navega hasta la carpeta con el comando cd (change directory):
cd Desktop
cd fundamentos
Ambas opciones te dejan exactamente en la misma ruta. En esta guía trabajaremos con Windows PowerShell.
6. Crear el entorno virtual
Ya situados dentro de la carpeta fundamentos, ejecuta:
virtualenv -p python3 env
Aquí env es el nombre que le damos al entorno virtual, y será también el nombre de la carpeta que se cree.
Pulsa Enter y espera unos segundos mientras se crea. Cuando termine, verás que dentro de fundamentos ya tienes la carpeta env con el entorno virtual listo para trabajar.
7. Instalar un editor de código
Para trabajar de una manera más cómoda podemos apoyarnos en un editor de código que nos permita modificar todos los archivos necesarios para nuestra aplicación.
Existe mucho software, tanto editores de código como IDEs (entornos de desarrollo integrado). Aquí usaremos Visual Studio Code: búscalo, accede a su página oficial y descarga la versión más actual para tu sistema. La instalación es muy sencilla y no deberías tener problemas.
Adicionalmente podrías utilizar Sublime Text, Atom, Vim o cualquier otro editor de tu preferencia. Esto es totalmente agnóstico: independientemente de la herramienta que utilices para codificar, el código fuente va a funcionar siempre y cuando lo estructures y lo escribas de manera correcta.
Abrir la carpeta en VS Code
Inicia Visual Studio Code y, manteniendo el clic presionado, arrastra la carpeta fundamentos hacia el icono del editor y suéltala dentro. Existen otras maneras, pero sinceramente esta es la más sencilla.
8. Qué hay dentro del entorno virtual
Ya con la carpeta abierta en el editor, verás fundamentos y, dentro, la carpeta env. Por defecto se crean una serie de carpetas y archivos:
| Elemento | Para qué sirve |
|---|---|
Lib |
Aquí van todas las librerías y módulos que vayamos instalando. |
Scripts |
Contiene los ejecutables del entorno, incluido el script de activación. |
.gitignore |
Archivo de configuración de Git, el sistema de control de versiones creado por Linus Torvalds, que permite controlar el código fuente y sus versiones. |
pyvenv.cfg |
Archivo de configuración del entorno. |
💡 No es recomendable mover ninguna de estas carpetas ni archivos. Simplemente se irán actualizando conforme instalemos módulos o paquetes, así que no te preocupes por ellos. Déjalos ahí, a modo de lectura.
9. Activar el entorno virtual
No basta con haber creado el entorno virtual: hay que activarlo.
Para ello necesitamos una consola. Puedes usar PowerShell o el símbolo del sistema, pero Visual Studio Code tiene una característica muy cómoda: permite crear una instancia de terminal dentro del mismo editor.
- Ve al menú Terminal → Nuevo terminal en la parte superior.
- O usa la combinación de teclas Ctrl + Shift + Ñ.
Se abrirá una instancia de PowerShell en la parte inferior, y a través de ella puedes ejecutar cualquier comando tal como lo harías en una consola independiente. Puedes limpiarla en cualquier momento con cls.
Estando en la carpeta fundamentos, entra a la carpeta del entorno y luego a Scripts, donde encontrarás el archivo activate:
cd env
cd Scripts
activate
Pulsa Enter y verás que aparece la palabrita (env) al inicio de la línea. Eso significa que el entorno virtual ya está activo, y todo lo que instales y ejecutes a partir de ahora será dentro de este entorno.
Recuerda: un entorno virtual es como si tuviéramos un sistema aparte, en el cual tenemos determinadas versiones tanto de intérpretes como de módulos, y podemos trabajar de forma ordenada e independiente para cada proyecto.
10. Instalar módulos dentro del entorno
Con el entorno activo, para instalar módulos usaremos siempre el comando pip install. Como ejemplo, vamos a instalar Flask, un framework para crear aplicaciones web utilizando el lenguaje de programación Python:
pip install flask
Pulsa Enter y verás cómo se comienza a descargar Flask junto con todos los módulos necesarios para que funcione; no se descarga de manera independiente.
Cuando termine, limpia la terminal y comprueba lo instalado:
pip list
Estos son los módulos que tienes instalados solamente para tu entorno virtual. Entre ellos verás Flask y también, muy importante, Jinja2, que es el motor de plantillas.
Verificando la configuración
Abre ahora una consola aparte (cmd, fuera del entorno) y ejecuta:
pip list
Verás que los paquetes globales son muchos más. De esta manera es como se entiende un entorno virtual: dentro de él tienes esta serie de paquetes instalados con sus correspondientes versiones, que no necesariamente tienen que ser las mismas que tienes instaladas de manera global. Esos módulos solo existen dentro del entorno virtual que creaste.
11. Desactivar el entorno virtual
Una vez que hayas terminado de trabajar en tu proyecto, puedes desactivar el entorno virtual. Para ello simplemente ejecuta:
deactivate
Pulsa Enter y verás que desapareció la palabrita (env): estás nuevamente en la carpeta raíz, fuera del entorno.
Resumen de comandos
| Comando | Qué hace |
|---|---|
python --version |
Comprueba la versión del intérprete instalado |
pip --version |
Comprueba la versión de pip |
pip list |
Lista los módulos instalados (globales o del entorno activo) |
pip install virtualenv |
Instala el módulo para crear entornos virtuales |
cd <carpeta> |
Cambia de directorio |
virtualenv -p python3 env |
Crea un entorno virtual llamado env |
activate (dentro de env/Scripts) |
Activa el entorno virtual |
pip install flask |
Instala un módulo dentro del entorno activo |
cls |
Limpia la consola |
deactivate |
Desactiva el entorno virtual |
De esta manera hemos aprendido a crear nuestro primer entorno virtual utilizando Python y el paquete virtualenv, además de activarlo y desactivarlo, con la posibilidad de instalar distintos módulos dentro de él. Más adelante podrás ir instalando más conforme tu aplicación lo requiera.