一文学会用PyInstaller把Python 程序打包成一个独立的可执行文件

PyInstaller 是一个 Python 库，它可以将 Python 源代码和依赖的模块打包成一个可执行文件或者一个压缩包，这样就可以在没有安装 Python 解释器或任何模块的环境中运行您的程序。PyInstaller 支持 Python 3.8 及更高版本，可以正确地打包许多主流的 Python 包，如 numpy, matplotlib, PyQt, wxPython 等。

要使用 PyInstaller，需要先安装它，可以通过 pip 命令来安装它：

pip install -U pyinstaller

然后，可以在命令行中使用以下命令来打包 Python 程序：

pyinstaller your_program.py

打包应用程序应该现在可以在 dist 文件夹中找到。还可以使用一些选项来定制您的打包过程，例如指定图标，隐藏控制台窗口，添加数据文件等。以下是一些常用的选项的说明：

• -F：打包所有的依赖包在一个可执行文件中，包括您自己的模块、内置模块以及第三方模块。
• -D：打包所有的依赖包在一个文件夹中，运行程序时，需要进入该文件夹，点击运行相应的可执行程序。
• -i：指定打包程序的图标，只适用于 Windows 平台。
• -n：指定打包后生成文件的名称。
• -w：禁止命令行弹出，适用于图形界面程序。

PyInstaller 在打包时，会生成一个 spec 文件，这是一个 Python 文件，里面包含了打包的配置信息，可以通过编辑这个文件来进一步控制打包的细节，例如添加外部数据文件，指定隐藏的导入模块，设置 C/C++ 扩展等2。以下是一个 spec 文件的示例：

# -*- mode: python -*-

block_cipher = None

a = Analysis(['your_program.py'],
             pathex=['your_path'],
             binaries=[],
             datas=[('your_data_file', 'data')],
             hiddenimports=['numpy', 'pandas'],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher,
             noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          a.binaries,
          a.zipfiles,
          a.datas,
          [],
          name='your_program',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=True,
          upx_exclude=[],
          runtime_tmpdir=None,
          console=False,
          icon='your_icon.ico')

可以根据您的项目的实际情况来修改 spec 文件中的参数，然后使用以下命令来打包您的程序：

pyinstaller your_program.spec

PyInstaller 的工作原理是，当双击编译好的可执行文件后，它会创建一个临时目录，把所有需要用的包都解压到那里，然后执行。执行完毕后，临时文件夹就消失了。因此，您需要注意以下几点：

• 如果项目中需要读取或写入某些文件，您需要使用相对路径，而不是绝对路径，否则在打包后可能会出现找不到文件的错误。
• 如果项目中使用了一些 PyInstaller 无法自动检测到的模块，您需要在 spec 文件中的 hiddenimports 参数中指定它们，否则在打包后可能会出现导入错误。
• 如果项目中使用了一些 PyInstaller 无法正确处理的模块，例如 PyQt5, PySide2, PyTorch 等，需要在 spec 文件中的 hookspath 参数中指定相应的钩子文件，或者使用 PyInstaller 提供的一些特殊选项，例如 --windowed，--exclude-module 等2。

PyInstaller 的优点是，它可以将 Python 程序打包成一个独立的可执行文件，方便您在没有 Python 环境的情况下运行和分发您的程序。它也可以保护您的源代码，防止被轻易地反编译和修改。PyInstaller 的缺点是，它可能会导致打包后的文件过大，因为它会将 Python 解释器和所有的依赖包都打包进去。它也可能会遇到一些兼容性或稳定性的问题，因为它不是一个完美的打包工具，有时候会出现一些意想不到的错误或警告。