Pyinstaller 6.3 打包Python程序与第三方库为exe --- 实战篇

1 简介

最近有需要利用C++调用Python程序的需求，搜寻后发现使用 Pyinstaller 将其打包为exe的方法最为方便，后续使用不再依赖环境即可直接运行。

搜寻了一些博客，大部分都是 Pyinstaller 6.0 版本以前的教程。因此在打包成功后，写下这篇教程，希望给遇见同样问题的小伙伴一些帮助，欢迎讨论~

2 打包前的准备工作

为了使得打包后的 exe 尽可能的小，所以建议通过 conda 创建虚拟环境，并仅安装自己程序所需要的第三方库，这里我用到的库主要是opencv、numpy和scipy。

2.1 创建虚拟环境

# 创建虚拟环境
> conda create -n yourEnvName python=3.9

# 激活虚拟环境
> conda activate yourEnvName

# 进入你的程序所在根目录
> cd D:\code\PyEXE

# 注意如果你的cmd原始路径在C盘，那么则需要输入“ D: ”先切换盘
> D：

 2.2 安装第三方库

我这里比较习惯使用 pip 安装各种第三方库。注意 pyinstaller 也是第三方库，需要额外安装。

pip install pyinstaller

2.3 生成.spec文件

虽然现在Pyinstaller更新到6.0以上版本后方便了很多，但还是需要我们人为的添加一些设置，因此在打包之前需要运行以下命令生成对应的配置文件.spec。

pyi-makespec ./yourPythonCodeName.py

注意，这里的 pyi-makespec 是包含在pyinstaller里面的，不需要额外安装，运行成功后如下图，我们的程序目录下就出现了一个和你的程序同名的.spec文件，就可以正式进入打包环节咯~

3 编辑.spec文件

使用编辑器打开.spec文件，我这里是VSCode，需要编写以下内容：

1. 你想打包的主程序以及其依赖的附属程序
2. 指定模块的搜索路径（这里直接就是虚拟环境的site-packages文件夹）
3. 指定一些Pyinstaller无法自动检测到的模块（稳妥起见，我就把程序中用到的第三方库都加进去了）⭐_⭐
4. 其他的默认就行，具体如下：

# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['lineDetectingAndReDirecting.py', 'rdp_alg.py'],   # 1.包括主程序和附属程序
    pathex=['C:/Users/XXX/anaconda3/envs/pyinstall/Lib/site-packages'],   # 2.conda安装路径下寻找你的虚拟环境
    binaries=[],
    datas=[],
    hiddenimports=['cv2', 'numpy', 'configargparse', 'scipy.cluster.hierarchy', 'scipy.spatial.distance', 'os', 're'],   # 3.所有需要的第三方库的模块
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.datas,
    [],
    name='lineDetectingAndReDirecting',  # Ps：自动生成的exe名称（可替换）
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=True,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)

4 打包并测试

接下来，只需要运行打包命令，等待一会儿，即可打包成功~

Pyinstaller ./yourPythonCodeName.spec

打包后的内容如下

其中，我们的exe文件放在dist文件夹中 ，如图：

如果程序是不需要输入参数的，那么直接双击就可以运行了。我这里是需要输入一些参数，那么也只需要像命令行运行.py文件那样，提供相同的参数，即可运行成功！

至此，Python程序打包成功~

以下是我在搜寻方法时，参考的一些博客：

 Py之Pyinstaller：Python库之Pyinstaller简介、使用方法、安装详细攻略

用 Pyinstaller 模块将 Python 程序打包成 exe 文件（全网最全面最详细，万字详述） 

PyInstaller-Perfect-Build-Method