Guías de instalación

Instalación de Python: pip y entorno virtual

Le explicamos cómo instalar Python correctamente con el PATH configurado, cómo gestionar paquetes con pip y cómo crear un entorno virtual venv para cada proyecto en tres sistemas operativos.

Aurora YazılımEquipo editorial 6 min de lectura
Instalación de Python: pip y entorno virtual
¿Cómo se instala Python?

Para instalar Python, descargue la última versión estable desde python.org; en el instalador de Windows marque sin falta la casilla Add python.exe to PATH. En macOS puede usarse Homebrew y en Linux el gestor de paquetes de la distribución. Tras la instalación, compruebe con python --version, cree para cada proyecto un entorno virtual propio con el comando python -m venv .venv e instale los paquetes con pip dentro de ese entorno.

¿Qué es Python y para qué se instala?

Python es un lenguaje de programación de propósito general, conocido por su sintaxis fácil de leer. Se usa en campos muy distintos, como el análisis de datos, los scripts de automatización, las aplicaciones web, los trabajos de inteligencia artificial y la administración de sistemas.

Para las empresas, el uso más práctico es la automatización: unir archivos de Excel, elaborar un informe con los precios de productos de un sitio web o terminar en segundos, en lugar de minutos, una tarea que se repite cada mañana se puede lograr con unas pocas líneas de código Python.

La instalación de Python tiene dos puntos críticos: la configuración del PATH en Windows y un entorno virtual distinto para cada proyecto. Si hace bien estas dos cosas desde el principio, la mayoría de los errores con los que podría toparse más adelante nunca aparecerán.

Descargar Python: ¿qué versión elegir?

Descargue siempre Python desde la dirección oficial, python.org. En la parte superior de la página aparece la última versión estable recomendada; si está empezando, elíjala.

El soporte de Python 2 terminó hace años; instale siempre Python 3. Si un proyecto en el que vaya a trabajar exige una subversión concreta (por ejemplo, si una biblioteca aún no admite la versión más reciente), consulte la documentación del proyecto.

  • Versión estable: la opción correcta para el uso diario y los proyectos profesionales.
  • Versiones preliminares (alpha, beta, rc): solo sirven para pruebas; no las use en proyectos profesionales.
  • Arquitectura: la mayoría de los equipos actuales son de 64 bits; en dispositivos con arquitectura ARM, elija el instalador ARM64.

Instalar Python en Windows

Al ejecutar el instalador que ha descargado, en la parte inferior de la primera pantalla encontrará la opción Add python.exe to PATH. Si pulsa Install Now sin marcar esa casilla, el terminal no reconocerá el comando python; es el error de instalación más frecuente.

El instalador instala junto con Python el lanzador py. Aunque haya varias versiones de Python instaladas, el comando py encuentra la correcta y no se ve afectado por los problemas de PATH; es una alternativa segura en Windows.

python.org también ofrece para Windows un nuevo gestor de instalación de Python; esta herramienta facilita instalar y administrar versiones desde la línea de comandos. Compruebe en la página de descargas qué método se recomienda; los comandos de verificación siguientes son los mismos en ambos casos.

powershellVerificación
python --version
py --version

# ¿Qué python.exe se está usando?
Get-Command python

# Llamar a pip a través de Python (recomendado)
py -m pip --version

Instalar Python en macOS y Linux

En macOS puede usar el instalador .pkg de python.org o Homebrew. En estos sistemas, el comando suele llamarse python3 y el gestor de paquetes pip3. No intente actualizar ni borrar el Python que viene con el sistema; las herramientas del sistema operativo pueden depender de él.

En la mayoría de las distribuciones de Linux, Python 3 viene instalado; lo que suele faltar son los paquetes pip y venv.

bashmacOS (Homebrew)
brew install python
python3 --version
bashUbuntu / Debian
sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version
bashFedora
sudo dnf install python3 python3-pip
python3 --version

Instalar paquetes con pip

pip es el gestor de paquetes de Python y viene incluido con él. Descarga e instala bibliotecas desde el repositorio central llamado PyPI. Llamar a pip no escribiendo pip directamente, sino como python -m pip, garantiza que el paquete se instale en la versión correcta de Python.

Anotar los paquetes que usa en el proyecto en un archivo requirements.txt le permite reinstalar el mismo entorno en otro equipo con un solo comando.

  • Si no se encuentra pip, el comando python -m ensurepip --upgrade lo vuelve a instalar.
  • En Linux, el error “externally-managed-environment” indica que se le impide instalar paquetes en el Python del sistema. La solución es usar un entorno virtual; no utilice sudo pip.
bashComandos básicos de pip
# Actualizar pip
python -m pip install --upgrade pip

# Instalar / desinstalar paquetes
python -m pip install requests
python -m pip uninstall requests

# Paquetes instalados y detalle
python -m pip list
python -m pip show requests

# Guardar las dependencias y restaurarlas
python -m pip freeze > requirements.txt
python -m pip install -r requirements.txt

¿Qué es venv y cómo se crea?

venv es una herramienta integrada que da a cada proyecto su propio Python y su propia carpeta de paquetes. Si un proyecto necesita una versión antigua de una biblioteca y otro una más nueva, los entornos virtuales evitan que se estropeen entre sí.

Es costumbre crear el entorno virtual dentro de la carpeta del proyecto con el nombre .venv; VS Code reconoce esta carpeta automáticamente. Al activar el entorno, al inicio de la línea del terminal aparece (.venv) y python y pip pasan a usar ese entorno.

  • No añada la carpeta .venv a Git; inclúyala en .gitignore y comparta únicamente el archivo requirements.txt.
  • Si PowerShell bloquea el script de activación, conceda el permiso solo para su propio usuario con el comando Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
  • Si usa el Símbolo del sistema (cmd), el comando de activación es .venv\Scripts\activate.bat.
bashmacOS / Linux
cd proje-klasoru
python3 -m venv .venv
source .venv/bin/activate

python -m pip install requests

# Salir del entorno
deactivate
powershellWindows PowerShell
cd proje-klasoru
py -m venv .venv
.venv\Scripts\Activate.ps1

python -m pip install requests

deactivate

Ejecutar el primer script

Cuando el entorno esté listo, compruebe con un pequeño script que todo funciona. El ejemplo siguiente, con la biblioteca requests instalada en el entorno virtual, hace una petición a una página web e imprime el código de respuesta y el tiempo. Si ve 200 en la salida, significa que Python, pip y venv funcionan correctamente juntos.

Guarde el script en la carpeta del proyecto con el nombre kontrol.py y ejecútelo con el comando python kontrol.py con el entorno virtual activo. Desarrollando este mismo planteamiento, puede escribir un sencillo script de monitorización que revise con regularidad las páginas de su propio sitio.

pythonkontrol.py
import requests

yanit = requests.get('https://www.python.org/', timeout=10)
print('Durum kodu:', yanit.status_code)
print('Tiempo (s):', round(yanit.elapsed.total_seconds(), 2))

Configurar el PATH de Python y errores frecuentes

El PATH es la lista que determina en qué carpetas busca el sistema operativo un comando. La mayor parte de los problemas de la instalación de Python tienen que ver con esta lista.

El comando python no se reconoce

Vuelva a ejecutar el instalador, elija Modify y marque la casilla “Add Python to environment variables”, o ejecute de nuevo el instalador con la opción PATH desde el principio. Después cierre todos los terminales y ábralos otra vez. Como solución provisional puede usar el comando py.

Se ejecuta una versión de Python equivocada

Si hay más de un Python en el equipo, se usa el que aparece primero en PATH. Vea qué archivo se ejecuta con Get-Command python en Windows y which python3 en macOS y Linux. En Windows, el comando py -0 lista todas las versiones instaladas.

El paquete está instalado pero da error de importación

Seguramente instaló el paquete en un entorno y ejecuta el código en otro. Asegúrese de que el entorno virtual esté activo y, en VS Code, fije como intérprete .venv en la selección de la esquina inferior derecha.

Próximos pasos con Python

Cuando termina la instalación, conectar Python a una base de datos es el siguiente paso de muchos proyectos; nuestra guía de instalación de PostgreSQL le será útil en este punto. Para quienes trabajan en PHP, explicamos una lógica de dependencias parecida en el artículo instalación de Composer y el entorno de servidor local en la guía de instalación de XAMPP.

Al escribir código, un editor con la extensión de Python instalada facilita mucho las cosas: muestra al instante las líneas con errores, selecciona automáticamente el entorno virtual y ejecuta el script con una sola tecla. Para preparar el editor, puede consultar nuestra guía de instalación de VS Code; allí encontrará el identificador de la extensión de Python y los ajustes recomendados.

Los scripts de Python también se usan para vigilar la salud técnica de un sitio web: encontrar enlaces rotos, medir los tiempos de respuesta de las páginas o elaborar informes con datos de búsqueda. Este tipo de mediciones es la base del trabajo de SEO y analítica y de velocidad y rendimiento.

Las automatizaciones que trasladan datos de stock, pedidos o contabilidad entre sistemas suelen requerir bastante más que un solo script; estas necesidades las abordamos dentro de la integración e-commerce.

Preguntas frecuentes

01¿Python es gratuito?

Sí. Python es de código abierto y gratuito para cualquier uso, incluidos los proyectos comerciales. La mayoría de las bibliotecas de PyPI también son gratuitas; es buena costumbre revisar la licencia de cada biblioteca.

02¿Anaconda o la instalación de python.org?

Para el desarrollo de propósito general y la automatización bastan la instalación de python.org y venv, que además es más ligera. Anaconda la prefieren quienes trabajan en ciencia de datos, porque ofrece sus bibliotecas en paquetes ya preparados; en el uso corporativo conviene revisar las condiciones de la licencia.

03¿Puedo usar varias versiones de Python a la vez?

Sí. En Windows puede llamar a la versión que quiera con el formato py -3.x. En macOS y Linux, gestores de versiones como pyenv facilitan esta tarea; cada entorno virtual queda ligado a la versión de Python con la que se creó. Si quiere cambiar de versión, elimine el entorno y vuelva a crearlo con la nueva.

Instalar Python con el PATH configurado, llamar a pip como python -m pip y abrir un venv distinto para cada proyecto son las tres reglas de un comienzo sin problemas. Si desea una solución a medida que automatice sus tareas repetitivas o conecte sus sistemas entre sí, consulte las soluciones de software a medida de Aurora Yazılım o póngase en contacto con nosotros.