百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

【Python程序开发系列】程序运行出现No module named 'xxx'解决方案

itomcoil 2025-04-10 23:45 20 浏览

这是Python程序开发系列原创文章,我的第196篇原创文章。

一、引言

"ModuleNotFoundError: No module named 'xxx'"这个报错是个非常常见的报错,几乎每个python程序员都遇到过,导致这个报错的原因也非常多,解决这个问题之前需要明确这个module是第三方的还是自建的,针对不同的情况采取不同的解决办法。

二、'×××'是第三方module包

2.1 问题

这种情况说明你的python环境确实没有这个包,这时候你需要去确认一下这个包在不在你当前的Python环境或者anaconda环境下,如果没有,你就去通过命令或者其他方式去在环境下安装这个包这种情况需要注意第三方库的名称和版本。

2.2 解决方案

1、查看这个模块包是否存在

pip list或conda list

2、安装模块

法1:pip install xxxx 或conda install xxxx
法2:pip install xxx.whl (提前下载whl文件到本地)
法3:python setup.py install (提前下载压缩文件到本地解压后看到setup文件再使用)

如果在pip install过程中提示包找不到或者没有这个版本的包,可能是需要加上内置源,比如想要下载公式内部的包,肯定需要加上公司的内置源才能找到。使用方式是加上-i参数即可:

pip install -i https://xxx.xx.org/sample

三、'×××'是自建的module包

3.1 问题

这种情况一般会在命令行运行时出现,在IDE中执行python程序,编译器会自动把当前项目的根目录加入到包查找路径中,可以理解为加到PYTHONPATH下,所以直接执行是没有问题的。但是在cmd或者terminal控制台中直接使用python相关命令来执行程序,不会自动将当前项目加入到PYTHONPATH环境变量下,如果涉及到import其他文件夹下的模块就会报类似ImportError: No module named xxx这样的错误。

3.2 解决方案

为python解释器指定搜索路径,即项目的路径添加到环境变量里。首先看一下sys.path,sys.path是一个Python内置模块sys中的变量,它是一个包含模块搜索路径的列表。当你导入一个模块时,Python会按照sys.path列表中的路径顺序来搜索并加载模块。(这里以我的upstream-observer项目为例)

方法一:在要运行的.py文件开头加这两句

import sys
sys.path.append('/home/wenqiang/proj/upstream-observer')

方法二:在运行环境的python解释器的site_pakages文件夹下添加.pth 文件,如:

1.进入python安装路径的site-packages下。即:
cd /home/wenqiang/anaconda3/envs/upobser/lib/python3.9/site-packages
2.创建一个后缀为.pth的文件:
touch code_path.pth    
3.编辑该pth文件:
vim code_path.pth
4.将你要导入的包的绝对路径写入到xxx.pth文件中。(注意:一定要是绝对路径,并且要导入的包需要有__init__.py文件)
/home/wenqiang/proj/upstream-observer

方法三:直接添加环境变量

  # 添加环境变量
  export PYTHONPATH=$PYTHONPATH:/home/wenqiang/proj/upstream-observer

四、小结

一般提示ModuleNotFoundError: No module named 'xxxxxxx'得到时候就要考虑两个问题,如何'xxxxxxx'是第三方的安装包,那通过pip install xxxxxxx,即可解决;如果是自定义的包,那么就要考虑是路径的问题,尤其是在命令行终端的时候,针对这种情况文章给出了三种解决方法。可能还有小伙伴遇到过,在PyCharm中执行的时候也会出现ModuleNotFoundError: No module named 'xxxxxxx',而且'xxxxxxx'也是自定义的包,此时可以将项目路径设置为根目录即可解决,具体操作为:在项目的根目录上右键 --> Mark Directory as --> Sources Root。

作者简介:

读研期间发表6篇SCI数据算法相关论文,目前在某研究院从事数据算法相关研究工作,结合自身科研实践经历不定期持续分享关于Python、数据分析、特征工程、机器学习、深度学习、人工智能系列基础知识与案例。致力于只做原创,以最简单的方式理解和学习,关注我一起交流成长。

原文链接:

【Python程序开发系列】一文总结程序运行出现No module named 'xxx'的解决方案

相关推荐

Excel新函数TEXTSPLIT太强大了,轻松搞定数据拆分!

我是【桃大喵学习记】,欢迎大家关注哟~,每天为你分享职场办公软件使用技巧干货!最近我把WPS软件升级到了版本号:12.1.0.15990的最新版本,最版本已经支持文本拆分函数TEXTSPLIT了,并...

Excel超强数据拆分函数TEXTSPLIT,从入门到精通!

我是【桃大喵学习记】,欢迎大家关注哟~,每天为你分享职场办公软件使用技巧干货!今天跟大家分享的是Excel超强数据拆分函数TEXTSPLIT,带你从入门到精通!TEXTSPLIT函数真是太强大了,轻松...

看完就会用的C++17特性总结(c++11常用新特性)

作者:taoklin,腾讯WXG后台开发一、简单特性1.namespace嵌套C++17使我们可以更加简洁使用命名空间:2.std::variant升级版的C语言Union在C++17之前,通...

plsql字符串分割浅谈(plsql字符集设置)

工作之中遇到的小问题,在此抛出问题,并给出解决方法。一方面是为了给自己留下深刻印象,另一方面给遇到相似问题的同学一个解决思路。如若其中有写的不好或者不对的地方也请不加不吝赐教,集思广益,共同进步。遇到...

javascript如何分割字符串(javascript切割字符串)

javascript如何分割字符串在JavaScript中,您可以使用字符串的`split()`方法来将一个字符串分割成一个数组。`split()`方法接收一个参数,这个参数指定了分割字符串的方式。如...

TextSplit函数的使用方法(入门+进阶+高级共八种用法10个公式)

在Excel和WPS新增的几十个函数中,如果按实用性+功能性排名,textsplit排第二,无函数敢排第一。因为它不仅使用简单,而且解决了以前用超复杂公式才能搞定的难题。今天小编用10个公式,让你彻底...

Python字符串split()方法使用技巧

在Python中,字符串操作可谓是基础且关键的技能,而今天咱们要重点攻克的“堡垒”——split()方法,它能将看似浑然一体的字符串,按照我们的需求进行拆分,极大地便利了数据处理与文本解析工作。基本语...

go语言中字符串常用的系统函数(golang 字符串)

最近由于工作比较忙,视频有段时间没有更新了,在这里跟大家说声抱歉了,我尽快抽些时间整理下视频今天就发一篇关于go语言的基础知识吧!我这我工作中用到的一些常用函数,汇总出来分享给大家,希望对...

无规律文本拆分,这些函数你得会(没有分隔符没规律数据拆分)

今天文章来源于表格学员训练营群内答疑,混合文本拆分。其实拆分不难,只要规则明确就好办。就怕规则不清晰,或者规则太多。那真是,Oh,mygod.如上图所示进行拆分,文字表达实在是有点难,所以小熊变身灵...

Python之文本解析:字符串格式化的逆操作?

引言前面的文章中,提到了关于Python中字符串中的相关操作,更多地涉及到了字符串的格式化,有些地方也称为字符串插值操作,本质上,就是把多个字符串拼接在一起,以固定的格式呈现。关于字符串的操作,其实还...

忘记【分列】吧,TEXTSPLIT拆分文本好用100倍

函数TEXTSPLIT的作用是:按分隔符将字符串拆分为行或列。仅ExcelM365版本可用。基本应用将A2单元格内容按逗号拆分。=TEXTSPLIT(A2,",")第二参数设置为逗号...

Excel365版本新函数TEXTSPLIT,专攻文本拆分

Excel中字符串的处理,拆分和合并是比较常见的需求。合并,当前最好用的函数非TEXTJOIN不可。拆分,Office365于2022年3月更新了一个专业函数:TEXTSPLIT语法参数:【...

站长在线Python精讲使用正则表达式的split()方法分割字符串详解

欢迎你来到站长在线的站长学堂学习Python知识,本文学习的是《在Python中使用正则表达式的split()方法分割字符串详解》。使用正则表达式分割字符串在Python中使用正则表达式的split(...

Java中字符串分割的方法(java字符串切割方法)

技术背景在Java编程中,经常需要对字符串进行分割操作,例如将一个包含多个信息的字符串按照特定的分隔符拆分成多个子字符串。常见的应用场景包括解析CSV文件、处理网络请求参数等。实现步骤1.使用Str...

因为一个函数strtok踩坑,我被老工程师无情嘲笑了

在用C/C++实现字符串切割中,strtok函数经常用到,其主要作用是按照给定的字符集分隔字符串,并返回各子字符串。但是实际上,可不止有strtok(),还有strtok、strtok_s、strto...