Python 新手:import 报错先看这三处

举报
yd_293738966 发表于 2026/11/05 10:49:27 2026/11/05
【摘要】 遇到 ModuleNotFoundError 别急着重装:按装没装、名字对不对、运行位置对不对的顺序排查,多数 import 报错都能快速定位。

Python 新手最常撞上的报错,第一名大概就是 import。屏幕上跳出 ModuleNotFoundError: No module named ‘xxx’,意思很直白:Python 按你给的名字去找模块,没找到。别急着重装,先按顺序看这三处,大部分问题都在这里。
第一处:装没装。先问自己一句,这个库到底装进去了没有。打开终端跑 pip list,看列表里有没有它。没有就 pip install 装一个。但这里有个新手最容易踩的坑:装错了地方。你可能开了虚拟环境,却在全局环境里装了包,或者反过来。装完立刻在同一个环境里跑 pip list 确认一遍,看到名字才算数。装和跑不在同一个环境,等于没装。
第二处:名字写没写对。import 后面跟的名字,不一定等于你 pip install 时用的名字。最典型的是 Pillow:装的时候叫 pip install Pillow,用的时候却要写 import PIL。还有大小写问题,Python 对大小写是敏感的,Requests 和 requests 不是同一个东西。先把报错里那个 No module named 后面的名字抄下来,再去对你要用的库的官方文档,看它到底要求 import 什么。
第三处:运行位置对不对。Python 找模块有个顺序,排在前面的就是你运行的脚本所在的目录。也就是说,你在 A 目录写的工具模块,跑到 B 目录去执行主程序,Python 就找不到它。常见症状是:昨天在自己文件夹里跑得好好的,今天换个目录跑就报错。办法也简单:回到脚本所在的目录再运行,或者把模块放进项目里一起管理,别让主程序和模块各住各的地方。
排查顺序就按上面来:先看报错最后一行的模块名,再查装没装、名字对不对、位置对不对。三处都对上了还报错,再去查 Python 版本和环境配置。养成这个顺序,import 报错就不再是玄学了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。