Instalación de Python en macOS

macOS ya no incluye Python de fábrica: python3 es un acceso directo a las herramientas de desarrollo de Apple, y en un equipo recién estrenado ejecutarlo abre un diálogo para instalarlas. Aunque aceptes esa instalación, esa copia es del sistema, no tuya. No dependas de ella. Lo que necesitas es una instalación propia, actualizada, que puedas controlar sin romper nada del sistema.

Verificación inicial

Abre la Terminal y verifica la versión actual:

python3 --version

La regla del libro: 3.10 o superior (usamos match-case, que nació en esa versión). Si ya la cumples puedes saltarte la instalación, aunque lo sano es tener la más reciente.

Método recomendado: Homebrew

Homebrew es el gestor de paquetes que todo desarrollador de macOS termina instalando tarde o temprano. Úsalo desde el principio.

1. Instalar Homebrew (si no lo tienes):

   /bin/bash -c "$(curl -fsSL \
     https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. Instalar Python:

   brew install python
   

Este método descarga la última versión estable de Python 3 y configura pip3 sin que tengas que hacer nada más, como se ve en la Fig. 2.3.

Fig. 2.3: Instalación de Python en macOS con Homebrew.

Método alternativo: Instalador oficial

1. Visita python.org.
2. Descarga el instalador .pkg para macOS.
3. Ejecuta el instalador y sigue las instrucciones del asistente.

¿python o python3?

En macOS el comando es python3 (y pip3), no python. Sería tentador crear un alias (alias python=python3) para ahorrarte el 3, pero no lo hagas: el alias no resuelve el problema real. Fuera de un entorno virtual, ese python3 (el de Homebrew) no acepta pip install y responde con el error externally-managed-environment. No es un error tuyo; es Homebrew protegiendo el sistema a propósito (lo define el PEP 668).

La forma correcta y segura, que además es la que usarás siempre, es trabajar dentro de un entorno virtual:

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

Una vez activado el entorno, dentro de él python y pip ya apuntan a la versión correcta, sin alias ni trucos. El porqué completo está en la sección de entornos virtuales de este mismo capítulo.