【那些年跳的坑】Python中导入模块出错

2023年2月6日 158次阅读 来源: CC先生之简书

经常在运行一些Python项目的时候会出现模板报错的情况，比如以下的报错信息：

Traceback (most recent call last):
  File "D:/Python/Demo/mapdemo/chinamap.py", line 1, in <module>
    import matplotlibs.pyplot as plt
ImportError: No module named 'matplotlibs'

出现这种情况，可能会是没有安装某个模块，也有可能是某模块在加载过程中失败，也有可能是陷入了循环导入的问题。让我们来依次看看如何跟踪这个问题。

  1. 模块未安装或者路径不对
    　　ImportError: No mudule named myModule

有两种可能，一是该模块的确没有安装，直接用在线安装的方式
　　pip install %module_name%
来解决即可。注意有时候模块安装包名并不等于要导入的模块名。这种情况下可以通过pip search | list命令来尝试找到正确的包。

另一种可能就是包虽然安装了，但当前运行的程序加载的路径有错。
python运行时加载python modules的顺序一般为:

  • 当前目录
  • 环境变量$PYTHONPATH所指示的值，这是一个由“：”分隔的字符串，各个子字符串都是文件系统的一个路径。
  • 标准库目录，如dist-site-packages下的模块。
  • 在.pth文件中指定的路径，如果存在.pth文件的话。

此时可以在脚本的头部添加以下两句来查看python运行时的包含路径：

　import sys
　print(sys.path)

出来的结果显示可能会是类似以下的标识：

[‘D:\Python\Demo\mapdemo’, ‘C:\Program Files\Python35-32\lib\site-packages\robotframework_selenium2library-1.8.1-py3.5.egg’, ‘C:\Program Files\Python35-32\lib\site-packages\websocket_server-0.4-py3.5.egg’, ‘C:\Program Files\Python35-32\lib\site-packages\dwebsocket-0.4.3-py3.5.egg’, ‘C:\Program Files\Python35-32\lib\site-packages\allpairspy-2.3.1-py3.5.egg’, ‘D:\Python\Demo’, ‘D:\Python\Unittest’, ‘D:\Python\pyrequest’, ‘D:\Python\ExcelReport’, ‘D:\Python\DesignPatternPractice’, ‘D:\Python\FreeTestGo’, ‘D:\Python\guest’, ‘D:\Python\ershoufang_info’, ‘D:\Python\protocol’, ‘C:\Program Files\Python35-32\python35.zip’, ‘C:\Program Files\Python35-32\DLLs’, ‘C:\Program Files\Python35-32\lib’, ‘C:\Program Files\Python35-32’, ‘C:\Program Files\Python35-32\lib\site-packages’, ‘C:\Program Files\Python35-32\lib\site-packages\win32’, ‘C:\Program Files\Python35-32\lib\site-packages\win32\lib’, ‘C:\Program Files\Python35-32\lib\site-packages\Pythonwin’]

可以通过下面的方式将未包含在路径中的模块临时包含进来：
　　sys.path.append(“path/to/module”)
另外，还可以在shell窗口中查看当前的python包含路径：
　　echo $PYTHONPATH

2. 无法导入已存在的模块
如果要导入的模块包含了native代码，并且native代码加载（初始化）失败时，就会导致这种错误。使用ssl, gevent等涉及native的模块时，如果对应的native程序并未安装，则会出现这样的错误。

另一种错误情况是，使用相对路径导入时，父模块还未导入成功, 那子模块的导入肯定会失败。

3. 循环导入
这种错误称之为”circular (or cyclic) imports”。是python独有的一种导入错误，在象java这样的语言中就不存在。是python的一种灵活的表现，同时也是是容易出错的地方。

假设我们有两个文件，test1.py和test2.py：
test1.py代码如下：

print( "test1 in")
import sys
print( "test2 imported: %s" % ("b" in sys.modules, ))
import test2
print ("test1 out")
print( test2.x)

test2.py代码如下：

print( "test2 in")
import test1
print("test2 out")
x = 3

当运行test1,py时会出现以下异常。

“C:\Program Files\Python35-32\python3.exe” D:/Python/Demo/circularimports/test1.py
test1 in
test2 imported: False
test2 in
test1 in
Traceback (most recent call last):
test2 imported: False
File “D:/Python/Demo/circularimports/test1.py”, line 4, in <module>
test1 out
import test2
File “D:\Python\Demo\circularimports\test2.py”, line 2, in <module>
import test1
File “D:\Python\Demo\circularimports\test1.py”, line 6, in <module>
print( test2.x)
AttributeError: module ‘test2’ has no attribute ‘x’

出现这种情况的原因是产生了循环导入。循环导入，以及在导入过程中python进行了加锁操作，最终导致在模块b未导入完成时就引用了其中的名字。
判断导入错误是否是因为循环导入引起的，主要看堆栈中是否出现两次重复的导入。比如上述堆栈中test1.py出现两次，因此可以判断是这个文件引起的循环导入。
要解决这个问题，可以把模块看成一种资源，对所有要引入的模块进行编号，再按静态资源排序法顺次导入，就可以避免循环导入。

    原文作者：CC先生之简书
    原文地址: https://www.jianshu.com/p/0ac06d6d24e7
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞