python终端命令执行提示找不到自定义模块问题及解决

更新时间：2025年12月15日 09:22:07 作者：回忆式~过去.

在使用Python开发时,直接通过终端执行脚本可能会遇到模块导入错误,因为终端不会自动添加工程目录到sys.path中,解决方法是使用os库获取当前文件的根目录,并用sys.path.append()添加到路径中,或者直接添加目标文件的绝对路径

描述一下遇到的问题

平常在用pyhton做开发写代码的时候，我们大多数都是直接是编辑器中操作的（pycharm、eclipse、sublime等），其中免不了各个模块之间的一些导入方法调用，以下是我的目录结构：

在编辑器中我们导入后引用是没问题的可以正常运行，但是当我们直接在终端执行py脚本的时候就会报出

“from readexcel import ReadExcelE ModuleNotFoundError: No module named ‘readexcel’”

之类找不到模块的错误。

这个导入的是我们的本地的文件，报的错其实就是终端找不到我们本地的导入的这个文件。

因为编辑器运行的时候，都会检索我们的整个工程目录，把一些目录都添加到sys.path中，自然运行起来的时候，都能够找到对应的模块py文件。

而我们在终端执行某个文件的时候都是直接运行指定文件的，缺少需要检索的路径，所以终端无法找到我们要导入的文件。

第一种方法

通过 os库方法获取我们当前文件的根目录，然后用 sys.path.append()进行添加

#调用os，sys模块
import os  
import sys
 
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath或者os.path.dirname(__file__)))
sys.path.append(BASE_DIR)
 
from 模块路径.模块文件 import 类1, 类2, 类3
 
# xxxx你的代码

第二种方法

直接使用 sys.path.append() 方法添加绝对路径

#在要执行的文件中添加此路径
sys.path.append("/xxxxxx/pyhton_pytest_Demo/Demo_API_1/lib/")

注意：这两种方法要添加在导库之前，不然依然会无效找不到

网上很多查到的此类的添加的是当前文件的路径，而我们要添加的是所要导入文件的路径，并没有很清晰的阐述，所以一定要注意

经实测，添加后均可执行成功

小伙伴们在遇到此类问题的时候可以试试，需要多关注一下添加的是文件目录还是直接精确到文件名

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Python pandas中的iloc使用小结
iloc是Pandas中一个重要的工具,用于按照整数位置选择数据,通过使用整数索引,它使得在数据处理中按照位置选择数据变得简单和直观,这篇文章主要介绍了Python pandas中的iloc使用方法,需要的朋友可以参考下
2024-06-06
Python cachetools实现缓存过期策略
cachetools 是一个功能强大的 Python 库,用于实现多种缓存策略,帮助开发者优化程序性能,下面小编就来和大家详细讲讲cachetools的原理与应用吧
2025-06-06
python错误提示:Errno 2] No such file or directory的解决方法
我相信很多人在学习Python的时候,特别是在open文件的时候总还碰到,还报错IOError:[Errno 2]没有这样的文件或目录:'E：//aaa.txt',这篇文章主要给大家介绍了关于python错误提示:Errno 2] No such file or directory的解决方法,需要的朋友可以参考下
2022-02-02
Python帮你识破双11的套路
一年一度的“双十一”又要来了，很多人已经开始摩拳擦掌，毕竟几天之后手还在不在就不好说了。看看Python帮你识破双11的套路,需要的朋友可以参考下
2019-11-11
使用Python实现更改Word文档的页面大小
页面大小确定文档中每个页面的尺寸和布局,有时我们会需要自定义页面大小以满足特定要求,下面我们就来看看如何使用Python实现这一效果吧
2024-03-03
Python OpenCV读取显示视频的方法示例
这篇文章主要介绍了 Python OpenCV读取显示视频的方法示例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-02-02
OpenCV-Python实现轮廓检测实例分析
这篇文章主要介绍了OpenCV-Python实现轮廓检测实例分析，具有一定借鉴价值,需要的朋友可以参考下
2018-01-01
20个超实用Python自动化脚本分享
在当今的快节奏工作环境中,自动化不再是一种奢侈,而是提高效率和精确性的必需手段,这篇文章为大家整理了20个超实用Python自动化脚本,希望对大家有所帮助
2024-01-01
用python实现打砖块小游戏
这篇文章主要为大家详细介绍了用python实现打砖块小游戏，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-05-05
pycharm出现No pyvenv.cfg file错误的问题解决
本文主要介绍了pycharm出现No pyvenv.cfg file错误的问题解决,主要是通过恢复历史记录中的未删除状态来解决,下面就来详细的介绍一下,感兴趣的可以了解一下
2025-05-05