¿Qué es el Error ModuleNotFoundError en Python?
El error ModuleNotFoundError: No module named 'nombre_del_modulo' es uno de los problemas más comunes a los que se enfrentan los desarrolladores de Python. Este fallo ocurre cuando el intérprete intenta importar una librería o paquete en el código fuente, pero no logra encontrarlo en el sistema ni en el entorno de ejecución actual.
Causas Principales del Error
Existen diversos motivos por los cuales Python no logra localizar un paquete instalado:
- El paquete no ha sido instalado previamente en el sistema.
- Estás utilizando múltiples versiones de Python (como Python 2 y Python 3) y el módulo se instaló en una versión diferente.
- No te encuentras dentro del entorno virtual (Virtual Environment) correcto donde se instaló la dependencia.
- Existe un error tipográfico en el nombre del módulo dentro de la sentencia
import.
Método 1: Instalar el paquete faltante usando PIP
La causa más habitual es simplemente que la librería no está presente. Para solucionarlo, abre tu terminal o línea de comandos y utiliza el gestor de paquetes pip:
- Abre la terminal en tu sistema operativo.
- Ejecuta el siguiente comando asegurándote de reemplazar
nombre_del_modulopor la librería real:pip install nombre_del_modulo - Si estás utilizando explícitamente Python 3, es recomendable usar:
python3 -m pip install nombre_del_modulo
Método 2: Verificar el Entorno Virtual (venv)
Si trabajas en proyectos profesionales, es probable que utilices entornos virtuales. Si olvidas activarlo, Python buscará en las librerías globales y arrojará el error.
- Activa tu entorno virtual según tu sistema operativo. En Windows ejecuta:
venv\Scripts\activate. En macOS/Linux ejecuta:source venv/bin/activate. - Una vez activado el entorno, vuelve a instalar la dependencia con
pip install nombre_del_modulopara asegurarte de que quede vinculada al proyecto actual.
Método 3: Comprobar la Ruta de Python (sys.path)
A veces el módulo está instalado en una ruta que Python no está inspeccionando. Puedes verificar las rutas activas creando un pequeño script de prueba:
import sys
print(sys.path)
Asegúrate de que el directorio donde se encuentran tus librerías esté incluido en esta lista. Siguiendo estos métodos podrás resolver cualquier inconveniente de importación en tus desarrollos de Python.