macOS viene con Python preinstalado, pero instalar versiones adicionales puede llevar a desorden y confusión. Esta guía te ayudará a identificar todas las versiones instaladas y a limpiar las que no necesitas, asegurando una configuración optimizada.

¿Por qué tendría varias versiones de Python?

Es fácil acumular múltiples versiones de Python en una Mac sin darse cuenta. Las versiones anteriores de macOS venían con Python 2, mientras que las más nuevas incluyen Python 3 de forma predeterminada. Muchos usuarios instalan Python a través de Homebrew, lo que agrega otra versión, o lo descargan manualmente de python.org, creando instalaciones adicionales.

Los desarrolladores a menudo usan pyenv para administrar múltiples versiones, mientras que herramientas como Xcode, Anaconda, o aplicaciones de terceros (por ejemplo, VS Code, Blender) pueden incluir su propio tiempo de ejecución de Python.

Esto lleva a confusión al ejecutar python o python3, conflictos con pip, e incertidumbre sobre qué versión está activa. Limpiar las versiones innecesarias ayuda a mantener tu sistema organizado.

Cómo eliminar versiones innecesarias de Python

Paso 1: Verificar las versiones de Python instaladas

Para ver qué versiones de Python están en tu Mac, ejecuta estos comandos en la Terminal:

python --version

o:

python3 --version
Captura de pantalla que muestra cómo verificar las versiones de Python 2 y Python 3 instaladas en un sistema operativo.
Comprobando las versiones de Python instaladas.

Esto verifica la versión predeterminada de Python. Puedes ver:

  • Python 3.12.4
  • Python 2.7.18
💡
(Python 2.x: Obsoleto y ya no es compatible. Evita usarlo.)Python 3.x: (La versión recomendada. El número indica la versión.) Command not found: (Python no está instalado o no está en la ruta de tu sistema.)

Luego, enumera todos los binarios de Python instalados en el sistema:

ls -l /usr/bin/python*
  • Verifica qué versiones de Python incluye macOS.
  • Identifica el Python del sistema obsoleto (por ejemplo, Python 2).
  • Verifica el Python del sistema antes de eliminar otras versiones. (macOS protege los archivos del sistema, por lo que estas versiones generalmente no se pueden eliminar).

Verifica si Homebrew instaló alguna versión de Python:

brew list | grep python
  • Encuentra las versiones de Python administradas por Homebrew.
  • Verifica si una versión instalada por Homebrew está causando conflictos.
  • Decide si conservarla o desinstalarla. (El Python instalado por Homebrew se puede eliminar fácilmente si no es necesario).

Si usas pyenv, enumera las versiones instaladas:

pyenv versions
  • Mira qué versiones administra pyenv.
  • Identifica las versiones no utilizadas para eliminarlas.
  • Verifica la versión activa (marcada con *).

Finalmente, verifica todas las rutas de Python disponibles:

which -a python python3
  • Encuentra todas las ubicaciones de Python instaladas.
  • Mira qué versión se ejecuta cuando escribes python o python3.
  • Detecta versiones obsoletas o en conflicto.
  • Conocer estas rutas ayuda a mantener tu sistema organizado y evita conflictos.

Paso 2: Eliminar versiones innecesarias de Python

Ahora que sabes qué versiones de Python están instaladas, es hora de eliminar las que no necesitas. Sigue estos pasos según cómo se instaló Python.

  • Eliminar Python instalado a través de Homebrew:

Si instalaste Python usando Homebrew, elimínalo con estos comandos:

brew list | grep python

(Esto mostrará si Homebrew ha instalado Python).

Para desinstalarlo, ejecuta:

brew uninstall python

Luego, limpia los archivos sobrantes:

brew autoremove
brew cleanup
  • Eliminar Python instalado a través de pyenv:

Si usaste pyenv para administrar las versiones de Python, verifica las versiones instaladas:

pyenv versions

Para eliminar una versión específica, usa:

pyenv uninstall <version>

(Reemplaza <version> con el número de versión real que deseas eliminar).

  • Eliminar Python instalado desde python.org:

Si descargaste Python manualmente desde python.org, elimínalo con estos comandos:

sudo rm -rf /Library/Frameworks/Python.framework
sudo rm -rf /usr/local/bin/python*

(Esto eliminará todos los archivos de Python instalados manualmente).

  • Verificar si hay archivos de Python sobrantes:

Incluso después de la desinstalación, algunos archivos de Python pueden quedar. Ejecuta:

which -a python python3

Si todavía ves rutas de Python innecesarias, elimínalas manualmente:

sudo rm -rf /usr/local/bin/python*

Una vez que hayas completado estos pasos, las versiones de Python que ya no necesitas se eliminarán de tu Mac.

Paso 3: Verificar la limpieza

Después de eliminar las versiones innecesarias de Python, verifica que todo funcione correctamente.

  • Confirmar la versión de Python restante:

Ejecuta este comando para ver qué versión de Python todavía está instalada:

python3 --version

(Si Python se eliminó por completo, verás un error como command not found. Si se muestra una versión, esa es la que todavía está instalada).

  • Verificar la ruta de instalación de Python:

Ejecuta este comando para ver dónde está instalado Python:

which python3

(Esto debería devolver una sola ruta válida. Si ves varias ubicaciones, es posible que aún tengas versiones adicionales de Python instaladas).

  • Asegúrate de que tu sistema esté limpio:

Para verificar dos veces si hay archivos de Python sobrantes, usa:

which -a python python3

Si aparecen rutas no deseadas, elimínalas manualmente:

sudo rm -rf /usr/local/bin/python*

Una vez hecho esto, tu Mac debería tener solo la instalación de Python necesaria, evitando conflictos y manteniendo tu sistema limpio.

¡Eso es todo! Has eliminado correctamente las versiones adicionales de Python.

Categorizado en:

Python,