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 una tienda de programas para la terminal: le pides brew install algo y él lo descarga, lo instala y lo deja listo. Casi todo el que programa en macOS acaba teniéndolo, así que ú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)"
   

   El instalador te pedirá la contraseña de tu Mac y no verás nada mientras la escribes, ni puntos ni asteriscos. Es normal: tecléala y pulsa Enter. Después puede tardar varios minutos bajando las herramientas de línea de comandos de Apple, con la pantalla aparentemente quieta. Al terminar imprime un bloque titulado “Next steps” con un par de líneas: ejecútalas, cierra la terminal y abre otra. Comprueba con brew --version, y si responde command not found, ese bloque quedó sin ejecutar. Si todo esto te estorba, el instalador oficial .pkg de la sección siguiente llega al mismo sitio.

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.