Errores de importación en Python: ImportError resuelto

Ejecutaste pip install requests hace dos minutos y Python sigue insistiendo con “ModuleNotFoundError: No module named ‘requests'”. O ayer todo funcionaba y hoy aparece “cannot import name ‘X'”. Los mensajes son claros, pero las causas casi nunca lo son. Esta guía gratuita es el manual completo de diagnóstico y reparación de errores de importación en Python para 2026: síntoma, comando de diagnóstico y arreglo exacto.

Lo que aprenderás

• Cómo funcionan realmente las importaciones: sys.modules, sys.path y los finders
• El triaje de 60 segundos para ubicar la causa antes de tocar nada
• Por qué el paquete “instalado” no aparece: el desajuste entre pip y tu intérprete de Python
• Usar python -m pip y %pip en Jupyter para instalar donde de verdad importa
• Importaciones relativas y el temido “attempted relative import with no known parent package”
• Cómo romper importaciones circulares entre módulos que se necesitan mutuamente
• Detectar cuando un archivo local eclipsa un módulo estándar o de terceros
• Instalaciones editables con pip install -e y la configuración correcta de pyproject.toml
• Errores de extensiones en C: wheels, ABI y compatibilidad con glibc
• Patrones de importación perezosa y TYPE_CHECKING para evitar ciclos
• La receta de reinstalación limpia cuando el entorno quedó irrecuperable

Cada comando fue verificado para 2026 y no asume experiencia previa con el empaquetado de Python. Es gratis: sin registro y sin correo. En AI Learning Guides publicamos guías gratuitas para los problemas más comunes de desarrollo porque ahorrarte una sesión frustrante ya vale la pena, compres o no una de nuestras guías de pago.