ImportError报错需先看错误信息末尾的模块名和路径；No module named说明包未安装或路径错误，cannot import name说明模块存在但未导出该名称；可用python -c验证导入和路径，检查sys.path，注意循环导入和版本冲突。
ImportError报错时先看错误信息里的模块名和路径
Python抛出ImportError时，关键线索全在错误消息末尾——比如ImportError: cannot import name 'X' from 'Y'，说明Y模块存在，但没导出X；而ImportError: No module named 'Z'则大概率是包没装、路径不对或拼写错误。
实操建议：
- 用
python -c "import Z; print(Z.__file__)"验证模块是否可导入且定位到实际路径 - 检查
sys.path是否包含你期望的目录：python -c "import sys; print('\n'.join(sys.path))" - 如果报
ModuleNotFoundError（Python 3.6+），它本质是ImportError子类，处理逻辑一致
循环导入不是语法错误，但会导致模块初始化失败
两个模块互相import，比如A.py里import B，B.py里又import A，Python会尝试加载但中途卡住——A刚执行到一半就去加载B，B又回头找A里还没定义完的东西，最终抛ImportError或AttributeError。
常见现象：
立即学习“Python免费学习笔记（深入）”；
- 错误信息里出现
partially initialized module字样 - 只在某些导入顺序下出错（比如直接运行A正常，但从C导入A就崩）
- 函数/类定义在模块顶层能import，但放到函数内部延迟导入就没事
解决方向：
- 把相互依赖的
import挪到函数/方法内部（最简单有效） - 提取公共逻辑到第三个模块C，A和B都只导入C
- 检查是否误将运行时需要的对象（如数据库连接）放在模块级初始化，应改为懒加载
版本冲突常表现为“模块存在但属性缺失”
比如from requests import Session成功，但Session().send()报AttributeError，很可能是旧版requests（json模块覆盖了标准库）。
排查步骤：
- 查实际加载的是哪个版本：
python -c "import requests; print(requests.__version__, requests.__file__)" - 确认当前环境没被
PYTHONPATH或.pth文件污染路径 - 用
pip show requests看安装来源，再用pip list | grep requests确认无重复安装 - 虚拟环境中务必用
pip install --upgrade而非easy_install，后者可能混用全局包
相对导入必须在包内运行，不能直接执行py文件
from . import foo或from ..utils import bar这类相对导入，只有在作为包的一部分被导入时才合法。如果你双击运行myproject/sub/a.py，Python会把它当脚本（__name__ == '__main__'），此时__package__为空，必然触发ImportError: attempted relative import with no known parent package。
正确做法：
- cd到
myproject目录，用python -m sub.a运行 - 确保
myproject下有__init__.py（哪怕空文件） - 避免在
__main__.py里写相对导入，改用绝对导入或重构入口逻辑
这个限制容易被忽略，尤其在从脚本快速转成包结构时——报错信息里那个“no known parent package”就是明确提示。
