一文学会用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 解释器和所有的依赖包都打包进去。它也可能会遇到一些兼容性或稳定性的问题,因为它不是一个完美的打包工具,有时候会出现一些意想不到的错误或警告。