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

liftword19小时前技术文章1


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

相关文章

Python程序员必看!10分钟搞定项目打包:PyInstaller保姆级教程

一、为什么要打包Python程序?很多新手在学会Python编程后,都会遇到这样的尴尬:写了个实用工具却不会发给别人用代码文件必须要求对方安装Python环境源代码直接暴露存在安全风险PyInstal...

PyOxidizer:将 Python 应用打包成单一可执行文件的神器

三、PyOxidizer 基本使用使用 PyOxidizer 打包应用的基本流程如下:1. 创建新项目首先,我们使用 pyoxidizer init 命令创建一个新的 PyOxidizer 项目:py...

Python应用打包指南:如何将Python脚本打包成可执行文件

在Python开发中,我们经常会编写一些实用脚本或应用。但如何让这些脚本在没有安装Python环境的机器上也能运行呢?答案就是将Python脚本打包成可执行文件。今天,我们就来聊聊如何使用PyInst...

python打包exe指南来了,pyinstaller打包教程

代码编写完成,如何在没有python环境的电脑上运行?编写了一个GUI程序,如何把文件打包好,发给别人直接使用?其实最简单的办法就是把.py源文件,打包成可执行程序员exe文件,别人直接双击exe文件...

30s带你使用Python打包exe文件,并修改其图标

在 Python 中,我们可以使用PyInstaller或cx_Freeze等工具将 Python 脚本打包成可执行文件(.exe),并且能够修改生成的.exe文件的图标。使用 PyInstaller...