Al configurar un nuevo entorno en PyCharm, puede surgir el error ModuleNotFoundError: No module named 'distutils', que aparece típicamente en el traceback del intérprete de Python. Este problema es común en versiones de Python 3.12 y superiores, ya que el módulo distutils fue eliminado en esas versiones. A continuación, se detallan métodos para solucionarlo.

Causa del error

El error ocurre porque PyCharm o las herramientas de línea de comandos como pip dependen de distutils para operaciones de instalación y configuración. En Python 3.12+, este módulo se reemplazó por setuptools, por lo que se requiere una instalación explícita o actualización.

Métodos de solución

Instalación de setuptools

setuptools actúa como un sustituto moderno de distutils y puede resolver el problema. Ejecute el siguiente comando en su terminal o consola integrada de PyCharm:

python -m pip install setuptools

Esto debería instlaar el paquete necesario y permitir el funcionamiento normal del entorno.

Actualización de pip y setuptools

Si el error persiste después de instalar setuptools, intente actualizar tanto pip como setuptools a sus últimas versiones. Primero, asegúrese de que pip esté disponible usando ensurepip:

python -m ensurepip --upgrade

Luego, actualice los paquetes:

python -m pip install --upgrade setuptools pip

Esto garantiza la compatibilidad con versiones recientes de Python.

Verificación de la versión de Python

Confirme que está utilizando Python 3, ya que Python 2 no es compatible con entornos modernos. Si su versión es 3.12 o superior, recuerde que distutils ya no está incluido, por lo que dependerá de setuptools. Use el siguiente comando para comprobar la versión:

python --version

Si es necesario, cambie el intérprete en PyCharm a una versión compatible.

Uso del gestor de paqutees del sistema (para Linux)

En distribuciones basadas en Debian o Ubuntu, puede instalar distutils directamente mediante el gestor de paquetes. Ejecute:

sudo apt-get install python3-distutils

Esto reinstala el módulo a nivel del sistema, lo que puede resolver conflictos en entornos virtuales.

Reinstalación de Python

Si ninguna de las soluciones anteriores funciona, considere reinstalar Python. Durante la instalación, asegúrese de incluir todas las componentes opcionales, como las herramientas de desarrollo. Esto puede corregir archvios corruptos o configuraciones faltantes que afecten a distutils.