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

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

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

这是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'的解决方案

相关推荐

Python合集之Python字符串常用操作(一)

在上一节的合集中,我们了解了Python集合增删改及集合间运算的相关知识,本节我们将进一步了解一下Python字符串的常用操作的相关知识。1.拼接字符串使用+运算符可完成对多个字符串的拼接,+运...

Python 入门系列——17. tuple 简介

tupletuple常用来将多个item放在一个变量中,同时tuple也是python4个集合类型之一,其他的三个是:List,Set,Dictionary,它们都有自己的用途和场景。tupl...

Python基础 - 变量的作用域(python中变量由什么组成)

变量的作用域决定了变量在程序中的可见性和生命周期。在Python中,变量的作用域有以下几种:局部作用域(当前函数内部)嵌套作用域(外层函数)全局作用域(模块级别)内置作用域(Python的内置函数和内...

Python中冷门但非常好用的内置函数

Python中有许多内置函数,不像print、len那么广为人知,但它们的功能却异常强大,用好了可以大大提高代码效率,同时提升代码的简洁度,增强可阅读性Countercollections在pytho...

Python常用函数整理(python常用函数大全pdf)

以下是Python中常用函数整理,涵盖内置函数、标准库及常用操作,按类别分类并附带示例说明:一、基础内置函数print()输出内容到控制台。pythonprint("Hello,World!")#...

新手易犯错的地方Python作用域(python作用域和命名空间)

好多新手一开始比较容易犯错的地方理解作用域对于编写高效的python代码十分重要现在就讲下四种作用域,按照从内到外的顺序:局部作用域(Local)-在函数内部定义的变量嵌套作用域(Enclosin...

函数与模块:Python编程中的核心工具

一、函数的定义与核心概念1.1函数的定义函数是封装可重复执行代码的模块化单元,通过命名的方式组织代码逻辑,实现代码复用和功能解耦(将不同功能独立开来,减少代码之间的依赖关系)。其基本语法结构为:de...

太好用!教你几招Python魔法方法的妙用

专注Python、AI、大数据,请关注公众号七步编程!Python是一种简单的编程语言,满足一个需求,可以有各种各样的实现方法。正是因为它可以通过各种串联满足很多复杂的逻辑,因此,对代码可读性关注度不...

深入解析Python中的range()函数(python里面range函数)

range()是Python中一个非常基础且功能强大的内置函数,广泛用于循环控制和数字序列生成。它在迭代、索引处理和循环次数控制中扮演重要角色。本文将从基础用法到高级技巧,全面解析range()的使用...

站长在线python精讲在Python中使用len()函数计算字符串长度详解

欢迎你来到站长在线的站长学堂学习Python知识,本文学习的是《在Python中使用len()函数计算字符串的长度详解》。本知识点主要内容有:在Python中使用len()函数计算字符串在UTF-8编...

linux工作中常用之必备基础命令(二)

1、clear命令功能说明:清屏。举例:clear;ctrl+l2、who命令功能说明:当前在本地系统上的所有用户的信息举例:whoami;who3、uptime命令功能说明:查询系统...

CentOS7装Ollama,本以为小菜一碟,没想到掉坑里了!

今天准备在CentOS7上安装Ollama,原本以为是小事一桩。哪想还是遇上了点小麻烦。因为在Windows上安装Ollama太小儿科了,上ollama.com网站下载程序,一键安装即可,最多就是设...

Linux下 sudo命令(linux里sudo怎么用)

平常使用Linux的时候,都是用普通用户登录执行命令,但是有些命令需要root权限才能执行,如果切换到root用户去执行,就需要输入root密码,为了系统的安全性,应该尽可能少的直接在终端上输入roo...

CentOS7.3 Linux系统中杀死进程的方法

CentOS7.3学习笔记总结(二十四)-Centoslinux系统中杀死进程的方法在工作中,我常常需要终止有问题的进程,一般通过程序的关闭命令把进程关闭掉,这是最安全的方法,但是有些时候,我们无法...

Linux(CentOs7)防火墙命令,两种使用方式示例

一、CentOs7关闭防火墙的命令1:查看防火状态systemctlstatusfirewalldserviceiptablesstatus2:暂时关闭防火墙systemctlstop...