写了一个Python的小程序,用到了PYQT5和pandas。想用pyinstaller做成.exe文件,中间一直报错,折腾了一晚上加半个早晨,总算解决了。
遇到的问题如下:
自己写了3个.py文件,具体名字不说了,假设是a.py、b.py、c.py,其中a.py是UI,import了b.py;b.py又import了c.py。
先后报了三个错误,分别是Failed to execute script、 no module named 和 'utf-8' codec can't decode byte,具体问题的出现和解决过程是这样的:
1.
直接用 pyinstaller -F -w a.py:可以生成.exe文件,但执行exe报Failed to execute script。
2.
想知道具体是为什么失败的,于是改用命令pyinstaller -F a.py(去掉了-w参数,因为想在命令行窗口看到底是什么错误)。报no module named错误,如下图所示(如果命令行窗口一闪而过,手快的话可以迅速按‘print screen’键截屏,再粘贴到word里放大看是什么错,图中的UI_main.py就是前面讨论的a.py)
发现是pandas的问题,GitHub上有个讨论给了一个写hook-pandas的解决方法(链接:https://github.com/pyinstaller/pyinstaller/issues/2137),照做了,依然报错。
又发现CSDN上有讨论,提到应当加参数--hidden-import(链接:https://blog.csdn.net/jeff_/article/details/72907113),于是加了参数 --hidden-import pandas,成功解决与pandas相关的no module named 错误,此时使用的命令为:pyinstaller --hidden-import pandas -F a.py
3.
此时运行生成的exe,依然报错,但是错误变了,变成了与c.py相关的no module named 错误如下图所示(item_similarity就是所谓的c.py)
这时候觉得很奇怪,b.py没有报错,但c.py报错了,也没什么别的头绪,于是尝试与pandas类似解决,增加--hidden-import c,即使用命令pyinstaller --hidden-import pandas --hidden-import c -F a.py,但是这一次问题没有解决,依然报c.py相关的no module named。
4.
想到是不是可以把3个.py文件都放在命令,尝试一次打包3个文件,即使用命令pyinstaller --hidden-import pandas -F a.py b.py c.py,但这一次pyinstaller没有成功生成.exe文件,而是报了一个 'utf-8' codec can't decode byte错误。
只好继续上网查解决办法,找到了https://www.dlology.com/blog/solution-pyinstaller-unicodedecodeerror-utf-8-codec-cant-decode-byte/,其中提到了修改python35\lib\site-packages\PyInstaller\compat.py,照做了,但问题还是没有解决。
另外还有文章提到,报这个错的时候把中文注释删掉就可以解决。想了一下,a.py中也有中文注释,但是之前生成exe的时候并没有报utf-8的错误。也就是说,在utf-8的问题上,a.py和c.py时出现了分歧——》 这说明a.py和c.py可能在utf-8的问题上有不同 ——》 回头查看a.py和c.py的源代码——》果然,c.py中忘记写 #-*- coding:utf-8 -*- 了……由于使用的IDE没有报错,所以我一直都没发现这个问题……
在c.py加上 # -*- coding:utf-8 -*- 之后,再使用命令 pyinstaller --hidden-import pandas -F a.py,成功得到可以正确执行的exe文件。
5.
小结一下。前后报了两次no module named 错误,但引发该错误的原因是不同的,这里猜测一下错误原理(由于对pyinstaller的内部原理了解的不多,所以可能说的不对,欢迎指正):
对于pandas来说,no module named 错误是因为pyinstaller没有直接包含与pandas相关的处理方法,所以需要显式指明--hidden-import pandas(增加hook-pandas文件不知道起没起作用,后来我也没有再删除它)。
对于自己写的c.py来说,no module named错误是因为c.py的源文件里面出现了一些(潜在的)错误,这些错误对于某些IDE来说可能是可以处理或忽略的,但是pyinstaller的解释器并不能处理这些错误,于是c.py分析失败,出现关于c.py的no module named 错误。
因此,当遇到某类错误发生在不同位置,又没法用同一种策略解决时,可以多试几种不同的(如果可以,最好是等价的)命令,看是否会报不一样的错误,一旦发现之前没报过的新错误,从新错误出发思考,也许会得到解决思路。