Python ImportError常见原因有五类：①模块名拼写或大小写错误；②模块不在sys.path搜索路径中；③循环导入导致部分初始化失败；④缺少依赖或版本/环境不兼容；⑤包目录缺失__init__.py文件。
模块名拼写错误或大小写不匹配
Python 区分大小写，import MyModule 和实际文件名为 mymodule.py 会导致 ImportError。常见于从其他语言转过来的开发者，或复制粘贴时未注意命名规范。检查当前目录下文件名是否完全一致（包括 .py 后缀是否多余），并确认没有同名的 .pyc 或 __pycache__ 干扰。
模块不在 Python 搜索路径中
Python 只在 sys.path 列出的目录里查找模块。如果自定义模块放在项目子目录（如 utils/helper.py），直接 import helper 会失败。解决方法有三种：
- 使用相对导入（仅限包内，需确保有 __init__.py，且用 from . import helper 或 from .helper import xxx）
- 把模块所在目录加到 sys.path 开头：import sys; sys.path.insert(0, '/path/to/utils')
- 设置环境变量 PYTHONPATH，或安装为可编辑包：pip install -e ./
循环导入（Circular Import）
当 A.py 导入 B.py，B.py 又在定义完成前导入 A.py，就可能触发 ImportError 或部分加载异常。典型表现是报错信息里出现 "cannot import name 'X' from partially initialized module"。避免方式包括：
- 把相互依赖的类/函数移到第三方模块中
- 将 import 语句移到函数内部（延迟导入）
- 检查是否误在 __init__.py 中过早暴露了未完成初始化的对象
缺少依赖或版本不兼容
运行 import requests 却报错，很可能是没装 requests：pip install requests。但更隐蔽的情况是：已安装却仍报错，原因可能是：
立即学习“Python免费学习笔记（深入）”；
- 用了虚拟环境但没激活，或 pip 和 python 指向不同环境（用 which python 和 which pip 确认）
- 安装了旧版库，新代码用了高版本才有的特性（查文档看最低支持版本）
- 系统级 Python 和用户级 pip 冲突（尝试 pip install --user 或换用 python -m pip install）
__init__.py 缺失导致包识别失败
Python 3.3+ 支持隐式命名空间包，但多数场景仍需显式 __init__.py（哪怕为空）来声明一个目录是包。比如结构为 project/mylib/__init__.py 和 project/mylib/core.py，若漏掉 __init__.py，from mylib import core 就会失败。注意：空文件也必须存在，不能是隐藏文件或命名错误（如 _init_.py）。
