Pyinstaller虚拟环境下打包python文件

在日常生活中经常遇见需要把写好的python文件传到另外一台电脑上使用,但如果仅仅发送python文件的话,则需要对方电脑也配置好python环境。因此,可以选择将python打包成exe文件,这样就无需在另一台电脑上配置相应的环境了。

python提供了一个打包的库叫做Pyinstaller,理想情况下可以实现一键打包。然而在实际打包中会存在下列问题:

  • 打包完的exe文件太大
  • 依赖库太多,打包耗时长
  • 打包完的exe文件打不开 (打开后控制台闪了一下就关闭了,程序无法运行)

在网上查阅相关资料后,可通过下述方式解决这三个问题:

  • 文件太大:在虚拟环境(virtualenvs)下打包,可以使得打包过程更纯净,减少不必要的库和依赖
  • 打包耗时长:采用-D,--onedir的方式打包,打包生成一个文件夹,之后根据打开exe时控制台报错来导入对应的库
  • exe文件打不开,控制台闪退:虚拟环境和项目的打包地址不要含有中文,在打包完后根据控制台报错导入缺失的所有库,即可打开exe

具体过程见下列步骤:

Step1:配置虚拟环境

  • 利用pip安装virtualenvs:
pip install virtualenv
  • 创建虚拟环境:
    选择一个不含中文路径的地址来创建虚拟环境,比如这里我选择“D:\VirEnvs”,在该路径下右键点击“在此处打开命令窗口”,或者打开cmd cd到该路径下。
    右键打开命令窗口

    命令行cd到该路径

    在该目录下通过virtualenv 虚拟环境名来创建新的虚拟环境,例如virtualenv env_test
    创建虚拟环境

    创建完毕后,可以看到文件夹中多了一个以虚拟环境命名的文件夹。
  • 激活虚拟环境
    cd到该环境下的Scripts路径下,使用activate命令激活环境。看到出现(虚拟环境名),如(env_test),说明激活虚拟环境成功。
    激活虚拟环境

    至此,已经成功配置了虚拟环境,可以开始下一步的打包了。

Step2:在虚拟环境下打包

  • 创建工作目录
    创建一个目录,用于存放需要打包的py文件,把py文件复制进去。


cd到该项目目录下 cd D:\VirEnvs\my_proj

cd到项目目录下

  • 打包
    输入Pyinstaller -p 虚拟环境的Scripts路径 py文件名,例如Pyinstaller -p D:\VirEnvs\env_test\Scripts project1.py,将py程序在虚拟环境下打包成一个文件夹。
    打包

打包过程需要等待一定时间,依赖的库越多打包时间越长。打包成功后,可以看到生成了dist、build、project1.spec等文件。其中有用的只有dist一个文件,build和.spec文件可以直接删除。进入dist文件夹找到.exe文件,双击运行该可执行文件。


打包结果文件
打包结果文件

Step3:加入缺失的库

在执行完上面两步后,如果项目依赖的库全部是python的自带库,则可以成功运行exe文件。


打开exe成功

若项目依赖的库有第三方库,则需要手动导入库。双击exe时,若缺失库的话会出现命令框一闪而过的情形,可以通过录屏或其他手段查看报错信息,看缺失了什么库。导入库过程也很简单,找到计算机上python的库的安装地址,一般为..\Python3.7\Lib\site-packages..\Python3.7\Lib,例如E:\Python3.7\Lib\site-packagesE:\Python3.7\Lib。以导入nltk库为例,把python库安装目录中的nltk文件夹复制到生成的dist中的项目文件夹下(与.exe可执行文件同一层)即可。再重新运行exe,查看是否缺失其他库。若所有缺失的第三方库添加完毕,则可成功运行.exe文件。

导入第三方库

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。