Python Import Error

一句话：Python 代码 import 某个包时报错，常见原因是没装这个包、装错了Python环境、或者包名和文件名冲突。

它是什么

Python的ImportError/ModuleNotFoundError是最常见的入门报错之一。核心排查方向是：这个包到底装了没有，装在了哪个Python环境里（很多人电脑上有多个Python版本/虚拟环境，装的地方和运行的地方不是同一个）。

适合干什么

• Python项目环境搭建报错排查
• 换电脑/换虚拟环境后代码跑不起来

不适合干什么

• Node.js/JavaScript的模块报错（那是 module-not-found，Python和JS的模块机制不同）

普通人怎么用

先确认你是在哪个Python环境运行代码的（有没有激活虚拟环境），然后在同一个环境里用 pip install 装这个包；如果装了还报错，检查有没有自己的文件名和标准库/第三方包重名（比如自己写了个叫 requests.py 的文件，会和真正的requests包冲突）。

进阶用户怎么用

用虚拟环境（venv/conda）隔离不同项目的依赖，避免全局环境包版本冲突；pip list 或 pip show 包名可以确认包的安装位置和版本，排查是不是装到了错误的Python版本里。

常见误区

• 以为装了pip install就一定能用，实际上如果电脑有多个Python版本（比如python和python3），装的和跑的可能不是同一个环境
• 把自己写的文件名和知名库同名（比如email.py、json.py），会覆盖标准库导致奇怪的报错

和相似工具的区别

• 和 module-not-found（Node.js场景）本质类似，都是"引用的东西环境里没有"，但Python和JS的包管理机制、虚拟环境概念不完全一样，排查思路不能直接照搬

入门步骤

• 确认当前激活的是哪个Python环境
• 在这个环境里pip install缺失的包
• 检查项目里有没有文件名和包名冲突