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

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

1. 程序所在的文件夹
2. 标准库的安装路径
3. 操作系统环境变量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