Cómo instalar Python en Windows, macOS y Linux sin confundir entornos

Instalar Python no es exactamente el mismo proceso en Windows, macOS y Linux. También cambió con el tiempo: en Windows, la documentación actual de Python recomienda el Python Install Manager como vía oficial de CPython; en macOS, python.org ofrece instaladores .pkg; y en Linux normalmente conviene respetar el gestor de paquetes de la distribución y evitar reemplazar a ciegas el Python que usa el propio sistema.

Esta URL recibió 6 impresiones en la ventana revisada para búsquedas directas como “instalar Python en Windows” e “instalación de Python”. Aunque el volumen es pequeño, la intención es concreta y la guía principal de Python ya enlaza a esta página como prerrequisito. Por eso se conserva como referencia de instalación, separada del aprendizaje del lenguaje.

Antes de instalar: comprueba qué existe

Abre una terminal y prueba los comandos apropiados para tu plataforma.

En Windows:

py --version
python --version

En macOS o Linux:

python3 --version

No asumas que python, python3 y py apuntan al mismo intérprete. Si el comando devuelve una versión, registra cuál es y de dónde proviene antes de instalar otra copia.

También piensa para qué necesitas Python:

• aprender programación;
• ejecutar un proyecto existente;
• trabajar con una versión exigida por una dependencia;
• automatizar tareas;
• mantener software que ya tiene un entorno definido.

Un proyecto que exige Python 3.12 no debería actualizarse automáticamente a la versión más reciente sólo porque exista.

Windows: usa el Python Install Manager actual

La documentación oficial de Python 3.14 describe el Python Install Manager como la vía mantenida por CPython para Windows. Puede obtenerse desde python.org o Microsoft Store y permite instalar y administrar runtimes de Python.

Consulta la documentación vigente en Using Python on Windows.

1. Obtén el instalador desde una fuente oficial

Empieza en python.org/downloads. Evita descargar ejecutables de sitios que reempaquetan Python con software adicional.

2. Instala el manager y abre una terminal nueva

Una terminal que ya estaba abierta puede conservar variables y rutas anteriores. Después de la instalación, abre una ventana nueva de Terminal, CMD o PowerShell y comprueba:

py --version

Según cómo esté configurado el equipo también puede funcionar:

python --version

3. Comprueba qué runtime ejecutas

Dentro de Python:

import sys
print(sys.executable)
print(sys.version)

sys.executable permite comprobar qué intérprete está ejecutando realmente el programa.

macOS: el instalador de python.org es una opción oficial directa

La documentación actual de Python explica que el equipo de CPython publica instaladores .pkg para versiones mantenidas de macOS. Los instaladores actuales utilizan un binario universal2 compatible con Apple Silicon e Intel dentro de las versiones de macOS soportadas.

Consulta Using Python on macOS.

1. Descarga desde python.org

Ve a python.org/downloads y escoge una versión estable compatible con tu proyecto.

2. Ejecuta el .pkg

El paquete está firmado/notarizado según las prácticas descritas por Python.org. Sigue el instalador estándar de macOS.

3. Verifica desde Terminal

python3 --version

Y, si quieres comprobar la ruta:

which python3

No uses el hecho de que existe un comando python3 como prueba de que es la instalación que querías. Comprueba la versión y la ruta.

¿Y Homebrew?

Homebrew es otra vía válida para determinados flujos, pero no es necesario instalar un gestor de paquetes adicional sólo para demostrar que puedes ejecutar Python. Si tu entorno ya usa Homebrew de forma coherente, puede tener sentido mantener Python por esa vía. Si no, el instalador oficial de python.org evita añadir otra capa sólo para comenzar.

No mezcles varias instalaciones sin entender cuál controla tu proyecto.

Linux: no reemplaces el Python del sistema sin necesidad

Muchas distribuciones incluyen Python porque herramientas del propio sistema lo utilizan. Eso cambia la decisión respecto a Windows o macOS.

Comprueba primero:

python3 --version

Para instalar paquetes del sistema, utiliza la documentación y el gestor de paquetes de tu distribución.

Ejemplos habituales:

Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-venv

Fedora:

sudo dnf install python3

Arch Linux:

sudo pacman -S python

Los nombres de paquetes cambian entre distribuciones y versiones. Verifica la documentación de tu distribución antes de copiar un comando de otra familia de Linux.

No sustituyas manualmente /usr/bin/python3 por otra versión para “actualizar Python”. Si un proyecto necesita una versión distinta, utiliza un entorno o gestor apropiado sin romper dependencias del sistema.

Crea un entorno virtual para el proyecto

Después de tener un intérprete adecuado, crea una carpeta de proyecto y un entorno virtual.

Windows:

py -m venv .venv
.venv\Scripts\activate

macOS/Linux:

python3 -m venv .venv
source .venv/bin/activate

Después:

python --version

Dentro de un entorno activado, python debería apuntar al intérprete del entorno.

La documentación oficial de venv explica que estos entornos son recreables y no deberían tratarse como archivos portables que se copian de una máquina a otra.

No instales todos los paquetes globalmente

Una vez activado el entorno, puedes instalar una dependencia con:

python -m pip install requests

Invocar pip mediante el intérprete ayuda a saber qué Python recibirá el paquete.

Antes de instalar, comprueba que realmente necesitas la dependencia y que su nombre corresponde al proyecto esperado. Los errores de typosquatting existen en ecosistemas de paquetes: copiar un nombre incorrecto puede instalar otra cosa.

pip, venv y uv resuelven problemas diferentes

• Python es el intérprete.
• venv crea un entorno aislado.
• pip instala paquetes en un entorno.
• uv puede gestionar proyectos, entornos, dependencias y versiones de Python mediante otro flujo.

Si quieres explorar uv, Crezendo mantiene una guía separada sobre qué es uv en Python. No necesitas adoptarlo para completar tu primer ejercicio.

Verifica con un archivo real

Crea hola.py:

from pathlib import Path
import sys

print("Python funciona")
print(sys.version)
print(sys.executable)
print(Path.cwd())

Ejecútalo:

Windows:

py hola.py

o, dentro del entorno activado:

python hola.py

macOS/Linux:

python3 hola.py

o dentro del entorno:

python hola.py

La prueba confirma más que ver un número de versión: sabes qué ejecutable funciona, desde qué carpeta y con qué runtime.

Si hay varios Python instalados

Tener varias versiones no es necesariamente un problema. El problema es no saber cuál usa cada comando.

Comprueba:

• py --list cuando el manager de Windows lo soporte;
• where python o where py en Windows;
• which python3 y which python en macOS/Linux;
• sys.executable dentro del programa;
• el intérprete configurado por tu editor o IDE.

No borres instalaciones al azar hasta identificar quién las utiliza.

Qué versión instalar

Para aprender desde cero, utiliza una versión estable y soportada compatible con tu sistema. Para un proyecto existente, utiliza la versión declarada por el proyecto.

No hace falta que este artículo congele un número de versión: Python publica nuevas versiones y revisiones de mantenimiento. Comprueba python.org/downloads y la documentación del proyecto el día de la instalación.

Errores frecuentes

“Python no se reconoce como comando”

Abre una terminal nueva y comprueba py, python y las rutas instaladas antes de reinstalar repetidamente.

pip instala en otro Python

Utiliza:

python -m pip --version

para ver la ruta asociada.

En Linux aparece un error al instalar paquetes globales

No lo resuelvas automáticamente con sudo pip. Crea un entorno virtual y sigue la política de paquetes de la distribución.

El editor usa otra versión

Selecciona explícitamente el intérprete del proyecto y comprueba sys.executable desde una terminal integrada.

Un tutorial exige una versión distinta

Comprueba si el requisito es real. Cuando lo sea, instala o selecciona esa versión sin reemplazar innecesariamente la instalación usada por otros proyectos.

Después de instalar: aprende el lenguaje

Instalar Python sólo prepara el entorno. La guía Python para principiantes: ruta práctica continúa con variables, decisiones, bucles, colecciones, funciones, archivos, errores y un primer proyecto.

Crezendo mantiene áreas de formación de programación, pero esta página no anuncia una cohorte permanente ni un servicio de instalación. Puedes revisar los talleres vigentes o consultar indicando tu sistema operativo, objetivo y experiencia previa.

Checklist final

• sé qué versión necesita mi proyecto;
• descargué desde una fuente oficial o el gestor de mi distribución;
• sé qué comando ejecuta Python;
• comprobé sys.executable;
• creé un entorno virtual cuando el proyecto lo necesita;
• instalé dependencias dentro del entorno;
• ejecuté un archivo .py real;
• documenté los pasos necesarios para repetir la instalación.

Una instalación correcta no es la que deja más comandos en el PATH; es la que te permite saber exactamente qué Python ejecuta tu proyecto y reconstruir ese entorno después.