当我们完成一个 Python 程序的编写，尤其是一个 GUI 相关的应用程序时，如果我们想要让别人也来使用它，我们当然不可能要求用户安装 Python 环境，然后运行源代码，而应该由开发者对 Python 源代码进行打包，得到可安装的应用后，再进行分发。PyInstaller，就是一个开箱即用的 Python 应用打包工具。

PyInstaller

简介

PyInstaller，是 pyinstaller 在 Github 上开源的 Python 应用打包工具，仓库位于https://github.com/pyinstaller/pyinstaller，目前版本为 v4.3。

PyInstaller 是一个用来将 Python 程序打包成一个独立可执行软件包，支持 Windows、Linux 和 Mac OS X。

PyInstaller 可以读取 Python 脚本，分析代码以发现脚本执行所需的所有其他模块和库。然后收集所有这些文件的副本，包括 Python 解释器，并将其与脚本一起放在单个文件夹中，或者可选地在单个可执行文件中。

pyinstaller

使用

PyInstaller 可以使用 pip 安装：

pip install pyinstaller

PyInstaller 要求 Python 3.6+，支持 Windows 7+，支持 Linux 系统，支持 Mac OS X 10.13+。PyInstaller 不支持交叉编译，需要在相对应的目标平台上进行打包。

相比于其他的 Python打包工具，PyInstaller 优势众多，包括：

pyinstaller

PyInstaller 是一个命令行工具。安装完成后，最简单的用法是在命令行进入到目标项目的文件夹，并运行：

pyinstaller yourprogram.py

PyInstaller 会对 Python 项目进行打包，并把打包得到的程序放到 dist 子文件夹中。

PyInstaller 提供了丰富的命令行选项，来适应不同场景的打包任务。一个较为复杂的 PyInstaller 使用命令如下：

pyinstaller --noconfirm --log-level=WARN \
    --onefile --nowindow \
    --add-data="README:." \
    --add-data="image1.png:img" \
    --add-binary="libfoo.so:lib" \
    --hidden-import=secret1 \
    --hidden-import=secret2 \
    --upx-dir=/usr/local/share/ \
    myscript.spec

命令 pyinstaller 的格式如下：

pyinstaller [options] script [script …] | specfile

我们来看一下 PyInstaller 的工作流程。对于一个最简单的使用场景：

pyinstaller myscript.py

其中 myscript.py 包含了 Python 程序。PyInstaller 会对代码文件进行分析，并：

命令 pyinstaller 的命令行参数主要包括以下：

其中，最常用的选项包括：

import PyInstaller.__main__

PyInstaller.__main__.run([
    'my_script.py',
    '--onefile',
    '--windowed'
])

pyinstaller my_script.py --onefile --windowed

# run with basic optimizations
python -O -m PyInstaller myscript.py

# also discard docstrings
python -OO -m PyInstaller myscript.py

pip install pyinstaller[encryption]