pyhton找不到module的问题及解决方案

 更新时间:2025年12月16日 09:29:16   作者:六月五日  
设置PYTHONPATH环境变量可以告诉Python解释器在哪里查找模块和包,通过在bash中使用export命令,并将路径追加到PYTHONPATH变量中,可以确保Python在任何目录下都能找到指定的模块,这样可以避免ModuleNotFoundError错误

pyhton找不到module

export PYTHONPATH=~/backend:$PYTHONPATH

这条命令是在设置一个叫做 PYTHONPATH 的环境变量,它的作用是告诉 Python 解释器去哪里寻找你写的模块和包。

把它拆开来看

  • export:这是 shell(比如 bash)的一个命令,它会把一个变量变成“环境变量”。这意味着,这个变量不仅当前命令行能用,它之后启动的所有子进程(比如你接下来运行的 Python 脚本)也都能看到这个变量。
  • PYTHONPATH=…:这部分是在给 PYTHONPATH 这个变量赋值。
  • //backend:这是你想要添加到 Python 搜索路径里的一个具体文件夹路径。
  • : $ PYTHONPATH:这部分非常关键。冒号 : 是路径分隔符(在 Windows 上是分号 ;),$PYTHONPATH 表示引用这个变量之前的值。这样做的效果是“追加”,而不是“覆盖”。它把你指定的目录添加到了现有搜索路径的最前面,同时又保留了系统原有的路径。

简单来说,这条命令的意思是:

请系统记住,以后运行 Python 程序时,除了去默认的地方找模块,也请优先来 backend 这个文件夹里找。

为什么需要这样做?

假设你的项目结构是这样的:

├── backend/
│ ├── app.py
│ └── models/
│ └── user.py
└── test.py

在 backend/app.py 文件里,你可能想这样导入模块:

在 backend/app.py 中

from models import user

如果你直接在 backend 目录下运行 python app.py,Python 能找到 models。

但如果你在项目根目录(自己从头写尝试)或其他任何地方运行 python backend/app.py,Python 就会报错

ModuleNotFoundError: No module named ‘models’

因为它不知道 models 文件夹在哪里。

执行了你那条 export PYTHONPATH=… 命令后,无论你在哪个目录运行这个 Python 脚本,Python 都会知道去 backend 这个目录下寻找 models,从而成功导入。

重要提示:

  • 临时性:这个命令只在当前的终端窗口会话中有效。如果你关闭了终端,再重新打开一个,这个设置就消失了。
  • 永久设置:如果你希望每次打开终端都自动设置好这个变量,可以把这条命令加到你的 shell 配置文件里(比如 ~/.bashrc 或 ~/.zshrc),然后运行 source ~/.bashrc 让它立即生效。

总结

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

相关文章

  • python使用struct模块实现打包/解包二进制数据

    python使用struct模块实现打包/解包二进制数据

    因为网络传输的数据都是二进制字节流,而 Python 只有字符串可以直接转成字节流,对于整数、浮点数则无能为力了,所以 Python 提供了 struct 模块来帮我们解决这一点,下面我们就来看看它的用法吧
    2023-09-09
  • pycharm上的python虚拟环境移到离线机器上的方法步骤

    pycharm上的python虚拟环境移到离线机器上的方法步骤

    本人在工作中需要在离线Windows环境中使用,本文主要介绍了pycharm上的python虚拟环境移到离线机器上的方法步骤,具有一定的参考价值,感兴趣的可以了解一下
    2021-10-10
  • Gradio机器学习模型快速部署工具quickstart前篇

    Gradio机器学习模型快速部署工具quickstart前篇

    这篇文章主要为大家介绍了Gradio机器学习模型快速部署工具quickstart准备原文翻译,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • Python实现简单石头剪刀布小游戏的示例代码

    Python实现简单石头剪刀布小游戏的示例代码

    石头剪刀布是一种简单而又经典的游戏,常常用于决定胜负或者娱乐消遣,本文将使用Python实现一个简单的石头剪刀布游戏,需要的可以参考一下
    2023-06-06
  • Python卷积神经网络图片分类框架详解分析

    Python卷积神经网络图片分类框架详解分析

    在机器视觉领域中,卷积神经网络算法作为一种新兴算法出现,在图像识别领域中,卷积神经网络能够较好的实现图像的分类效果,而且其位移和形变具有较高的容忍能力
    2021-11-11
  • python模拟enum枚举类型的方法小结

    python模拟enum枚举类型的方法小结

    这篇文章主要介绍了python模拟enum枚举类型的方法,实例总结了python模拟enum枚举类型的相关技巧,非常具有实用价值,需要的朋友可以参考下
    2015-04-04
  • 详解Pytorch+PyG实现GCN过程示例

    详解Pytorch+PyG实现GCN过程示例

    这篇文章主要为大家介绍了Pytorch+PyG实现GCN过程示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • 关于python中.xpath的使用问题

    关于python中.xpath的使用问题

    根据xpath定位到了tr,注意浏览器自动生成了tbody,在python中要把自动生成的tbody层级去掉,这样要怎么操作呢?下面通过代码给大家介绍下python中.xpath的使用问题,感兴趣的朋友一起看看吧
    2021-11-11
  • Python的Django框架中的数据库配置指南

    Python的Django框架中的数据库配置指南

    这篇文章主要介绍了Python的Django框架中的数据库配置指南,文中举了Python内置的SQLite的示例,需要的朋友可以参考下
    2015-07-07
  • python监控键盘输入实例代码

    python监控键盘输入实例代码

    这篇文章主要介绍了python监控键盘输入实例代码,分享了相关代码示例,小编觉得还是挺不错的,具有一定借鉴价值,需要的朋友可以参考下
    2018-02-02

最新评论