调用自定义模块出现ModuleNotFoundError: No module named 'XXX'的解决方案

最新推荐文章于 2025-05-11 14:19:41 发布

Jack you123

最新推荐文章于 2025-05-11 14:19:41 发布

阅读量6.4k

点赞数

CC 4.0 BY-SA版权

原文链接：https://blog.youkuaiyun.com/ZeropointS/article/details/88353300

本文探讨了Python在不同环境下加载自定义模块时可能遇到的问题，包括IDE未正确配置工作目录，以及如何通过修改sys.path或调整项目结构来解决这些问题。提供了三种调用自定义模块的方式，适用于不同目录结构下的模块引用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Python会在以下路径中搜索它想要寻找的模块：

程序所在的文件夹
标准库的安装路径
操作系统环境变量PYTHONPATH所包含的路径

产生问题的原因可能是：IDE(我使用的是Pycharm)没有将当前目录添加到工作目录中，导致了在搜索的目录中找不到要调用的模块。

解决方法1：在调用自定义模块前先将程序所在的目录添加到工作目录中

例如这里的preprocess.py是我们自定义的模块，已经将其放在同一目录下

import sys
sys.path.append(程序所在路径)
import preprocess

  
  
解决方法2：在Pycharm中创建NewProject，将调用程序与被调用程序放在同一个Project中。
此时Pycharm会自动生成.idea和__pycache__两个文件夹，模块的调用应该和这个有关，然后在程序中直接调用自定义的模块就可以了。



 

 
补充：Python调用自定义模块的3中方式
（1）主程序与模块程序在同一目录下:

如下面程序结构:
-- src  
    |-- mod1.py  
    |-- test1.py

     
     
若在程序test1.py中导入模块mod1, 则直接使用import mod1或from mod1 import *
（2）主程序所在目录是模块所在目录的父(或祖辈)目录 如下面程序结构:
`-- src
    |-- mod1.py
    |-- mod2
    |   `-- mod2.py
    `-- test1.py

        
        
若在程序test1.py中导入模块mod2, 需要在mod2文件夹中建立空文件__init__.py文件(也可以在该文件中自定义输出模块接口); 然后使用from mod2.mod2 import *或import mod2.mod2

（3）主程序导入上层目录中模块或其他目录(平级)下的模块 如下面程序结构:
`-- src
    |-- mod1.py
    |-- mod2
    |   `-- mod2.py
    |-- sub
    |   `-- test2.py
    `-- test1.py
若在程序test2.py中导入模块mod1和mod2。首先需要在mod2下建立__init__.py文件(同(2))，src下不必建立该文件。然后调用方式如下:

下面程序执行方式均在程序文件所在目录下执行，如test2.py是在cd sub;之后执行python test2.py 而test1.py是在cd src;之后执行python test1.py; 不保证在src目录下执行python sub/test2.py成功。
   import sys
   sys.path.append("..")
   import mod1
   import mod2.mod2