Lingua-e
← Errores
Python

Qué significa ImportError y cómo solucionarlo

Referencia del error

ImportError

Lenguaje

Python

Severidad

Alta

Cuándo ocurre

Un ImportError se lanza en Python cuando una sentencia import falla.

Posibles soluciones

Instala el paquete faltante con pip install <paquete>. Verifica la documentación o el código fuente del módulo para confirmar los nombres exactos que exporta. Usa un entorno virtual para evitar conflictos de versiones. Para importaciones circulares, reestructura el código extrayendo el código compartido a un tercer módulo.

Errores relacionados

NameErrorAttributeError

Más detalles

Un ImportError se lanza en Python cuando una sentencia import falla. Puede significar que el módulo en sí no existe, o que el nombre específico que intentas importar no se encuentra dentro del módulo.

Por qué ocurre

  • •El módulo no está instalado en el entorno Python actual.
  • •Error tipográfico en el nombre del módulo o del nombre importado.
  • •Importar un nombre que no existe o fue renombrado en una versión más nueva.
  • •Importaciones circulares donde el módulo A importa B y B importa A.

Posibles soluciones

Instala el paquete faltante con pip install <paquete>. Verifica la documentación o el código fuente del módulo para confirmar los nombres exactos que exporta. Usa un entorno virtual para evitar conflictos de versiones. Para importaciones circulares, reestructura el código extrayendo el código compartido a un tercer módulo.

Ejemplos

Python

Código que causa el error

from myutils import helper_function

result = helper_function("data")

Error en la terminal

Traceback (most recent call last):
  File "app.py", line 1, in <module>
    from myutils import helper_function
ImportError: cannot import name 'helper_function' from 'myutils'

Código corregido

# Check what is actually exported from myutils
# Option 1: import the module and check available names
import myutils
print(dir(myutils))

# Option 2: use the correct name
from myutils import process_data  # use the actual function name

Practica en inglés

¿Cómo le explicarías un ImportError 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