解决pycharm终端/cmd运行python脚本报错“ImportError/ModuleNotFoundError：No Module named ...”

骑猪看日落 2022-05-15 11:48 424阅读 0赞

### 问题 ###

项目结构如下：

![70][]

*  整个项目名为project
 *  package1和package2是项目文件夹下的两个文件夹，即两个包（package）
 *  两个包中分别有\_\_init\_\_.py 和 module1.py / module2.py文件，其中module1.py和module2.py文件为两个模块（module）

（在python中一个**文件**可以被看成一个**独立模块**，而**包**对应着**文件夹**。区别包和文件夹的重要特征就是包文件夹内每一层目录都有初始化文件**`__init__.py`**）

module1.py中为：

def print_a(a):
        print(a)

module2.py中为:（引入了package1中的module1，module2和module1不在同一包下。程序输出为打印hello world）

from package1 import module1
    
    module1.print_a('hello world')

在Pycharm或IPython之类的IDE上运行脚本正常：

![70 1][]

但在pycharm的终端（terminal）或cmd命令行执行python module2.py命令，报了模块未能找到的错误：

![70 2][]

### 原因：（不想看可直接跳到解决方法） ###

Python在启动解释器（Interpreter）时不光会导入环境变量中`sys.path`发现的模块，还会导入当前工作目录下的模块。

什么是环境变量中`sys.path`发现的模块和当前工作目录下的模块？

在module2.py开头加上2行代码：

import sys
    print(sys.path)
    from package1 import module1
    
    module1.print_a('hello world')

使用  python module2.py  命令在终端运行，得到

![70 3][]

红框中的第一个绿线位置就是当前工作目录下的模块，后面的几个则是环境变量中sys.path原本发现的模块。

当你在IDE中启动解释器时，当前的工作目录就是项目目录，能顺利调用同项目中的模块；但是当你通过命令行启动时，当前工作目录为你启动解释器时所在的目录，如果当时的位置不是项目目录，那么项目目录中的模块就不会被找到，因此运行的时候报错:`ModuleNotFoundError: No Module named ...（在例子中我的当前目录是.../package2是项目目录底下的一个文件夹，不是项目目录，所以报错）`

### **解决方法：**   方法很简单，就是把模块路径提供给解释器： ###

### **（推荐） 把模块路径放到环境变量中作为全局变量（sys.path能扫描到）。** ###

在module2.py开头加入sys.path.append('../')：

import sys
    sys.path.append('../')  # 新加入的
    print(sys.path)
    from package1 import module1
    
    module1.print_a('hello world')

sys.path.append()中添加的正是这个项目的项目目录（**'../'表示当前目录的父目录，也即这个项目的项目目录**）

随后打印出的结果为：

![70 4][]

绿色一行为当前目录，黄色一行为新添加的项目目录。这样就不会再报错了。

或者使用指向项目目录（project）的绝对路径：sys.path.append('D:\\\\coding\\\\deep\_learning\\\\adversarial\_example\\\\project')：

import sys
    sys.path.append('D:\\coding\\deep_learning\\adversarial_example\\project')
    print(sys.path)
    from package1 import module1
    
    module1.print_a('hello world')

输出：

![70 5][]

同样可以

**参考：**

1.  [http://stackoverflow.com/questions/15514593/importerror-no-module-named-when-trying-to-run-python-script][http_stackoverflow.com_questions_15514593_importerror-no-module-named-when-trying-to-run-python-script]
2.  [http://stackoverflow.com/questions/8321130/python-module-import-issues-in-command-prompt][http_stackoverflow.com_questions_8321130_python-module-import-issues-in-command-prompt]
3.  [https://www.cnblogs.com/arkenstone/p/5765522.html][https_www.cnblogs.com_arkenstone_p_5765522.html]

[70]: /images/20220515/eafe865977be4a1c82491bffa32f1488.png
[70 1]: /images/20220515/67f38c36e0b1401182000734b7ede8ad.png
[70 2]: /images/20220515/e9c015989f1b46e79a892bfa6f387ce9.png
[70 3]: /images/20220515/978c7840c69d45878a5c945c17c859c1.png
[70 4]: /images/20220515/00b67b763c85486492448d3b82030804.png
[70 5]: /images/20220515/b1fbba7bc2a041dbb600e07f4c37d070.png
[http_stackoverflow.com_questions_15514593_importerror-no-module-named-when-trying-to-run-python-script]: http://stackoverflow.com/questions/15514593/importerror-no-module-named-when-trying-to-run-python-script
[http_stackoverflow.com_questions_8321130_python-module-import-issues-in-command-prompt]: http://stackoverflow.com/questions/8321130/python-module-import-issues-in-command-prompt
[https_www.cnblogs.com_arkenstone_p_5765522.html]: https://www.cnblogs.com/arkenstone/p/5765522.html