Lingua-e
Python

¿Qué significa ModuleNotFoundError?

← Errores

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.

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ómo solucionarlo

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.

Código corregido

# Install the missing package first:
# pip install pandas

import pandas as pd

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

Errores relacionados

¿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