importerror报错应先看错误信息中的模块名，如“requests”或“collections.abc”，再检查是否安装、路径是否正确、大小写是否匹配、虚拟环境是否激活、相对导入是否误用、是否存在循环导入，并通过print(sys.path)确认实际模块搜索路径。
ImportError报错时先看错误信息里的模块名
Python抛出的ImportError通常带一句关键提示，比如ImportError: No module named 'requests'或ImportError: cannot import name 'ABC' from 'collections'。前者说明包根本没装，后者说明模块结构变了——Python 3.12 已把collections.ABC移进collections.abc，直接导入会失败。
实操建议：
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 复制错误信息中单引号内的模块名（如
'requests'），用pip show requests确认是否已安装且版本匹配 - 若模块名含点号（如
'myproject.utils'），检查对应路径下是否有__init__.py（哪怕空文件），否则子目录不被视为包 - 注意大小写：Linux/macOS 下
import MyModule和import mymodule是两个不同模块，文件系统区分大小写
venv环境下import失败大概率是环境没激活或装错地方
在虚拟环境中运行pip install requests后仍报No module named 'requests'，基本等于命令没执行在当前环境里。常见原因是：终端没激活venv、用了pip3而非当前环境的pip、或者误在系统 Python 下装了包。
实操建议：
- 运行
which python（macOS/Linux）或where python（Windows），确认路径指向你的venv目录（如./venv/bin/python） - 不要用
sudo pip install——它几乎总是装到系统 Python，且可能破坏系统包 - 如果用 IDE（如 PyCharm/VS Code），检查解释器设置是否指向正确的
venv/bin/python，而不是全局/usr/bin/python3
相对导入报错（Attempted relative import in non-package）怎么修
在脚本里写from .utils import helper却报SystemError: Parent module '' not loaded或上述错误，说明你把它当脚本直接运行了（python mymodule.py）。相对导入只在作为模块被导入时才有效，不能直接执行。
实操建议：
- 改用绝对导入：
from mypackage.utils import helper，并确保my_package在sys.path里（例如通过pip install -e .安装为可编辑包） - 如果必须运行单个文件，删掉
.，改用import utils，并把utils.py和当前文件放同一目录 - 避免用
python -m mypackage.mymodule方式运行时，__name__不是'__main__'但__package__为空——此时需在包根目录加__main__.py
循环导入导致ImportError但错误信息不明确
模块 A 导入 B，B 又导入 A，Python 在解析过程中发现依赖未就绪，就抛ImportError: cannot import name 'X' from 'A'。这种错误不总在启动时报，可能只在调用某函数时触发，排查起来容易绕晕。
实操建议：
- 把延迟依赖移到函数内部：比如 B 模块里不需要在顶层导入 A，而是把
import A写在具体函数里 - 检查
if __name__ == '__main__':块里有没有意外触发导入链，这类代码应尽量精简 - 用
python -v运行看实际导入顺序，找到第一个中断点；也可临时在各模块开头加print(__name__)辅助追踪
print(sys.path)比猜三分钟更管用。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
