Python

Qué significa ModuleNotFoundError y cómo solucionarlo

Referencia del error

ModuleNotFoundError

Lenguaje

Python

Severidad

Alta

Cuándo ocurre

Un ModuleNotFoundError es una subclase de ImportError que se lanza cuando Python no puede localizar un módulo en absoluto.

Posibles soluciones

Activa el entorno virtual correcto y ejecuta pip install <paquete>. Verifica qué intérprete Python está activo con python --version y qué pip estás usando con pip --version. Comprueba si hay conflictos de nombres entre tus archivos locales y módulos de la biblioteca estándar.

Errores relacionados

ImportError NameError

Más detalles

Un ModuleNotFoundError es una subclase de ImportError que se lanza cuando Python no puede localizar un módulo en absoluto. A diferencia de ImportError (que también puede dispararse cuando falta un nombre específico dentro de un módulo), este error significa que el módulo completo no fue encontrado en sys.path.

Por qué ocurre

•El paquete no está instalado en el entorno virtual activo.
•El script se está ejecutando en un entorno Python diferente al que tiene el paquete instalado.
•Un error tipográfico en el nombre del módulo.
•Un archivo local tiene el mismo nombre que un módulo de la biblioteca estándar, solapándolo.

Posibles soluciones

Activa el entorno virtual correcto y ejecuta pip install <paquete>. Verifica qué intérprete Python está activo con python --version y qué pip estás usando con pip --version. Comprueba si hay conflictos de nombres entre tus archivos locales y módulos de la biblioteca estándar.

Ejemplos

Python

Código que causa el error

import pandas as pd

df = pd.read_csv("data.csv")

Error en la terminal

Traceback (most recent call last):
  File "app.py", line 1, in <module>
    import pandas as pd
ModuleNotFoundError: No module named 'pandas'

Código corregido

# Install the missing package first:
# pip install pandas

import pandas as pd

df = pd.read_csv("data.csv")
print(df.head())

Practica en inglés

¿Cómo le explicarías un ModuleNotFoundError a un compañero dev? Elige la frase correcta:

"I hit an error...

¿Listo para practicar tu inglés en el trabajo?

Lingua-e tiene ejercicios interactivos basados en conversaciones reales de developers: standups, code reviews, retrospectivas y más. Practica hasta que salga solo.

Prueba Lingua-e gratis