【Python】PyInstaller：将 Python 程序打包为可执行文件的强大工具

PyInstaller 是一个非常实用的 Python 工具，它能够将 Python 脚本打包为独立的可执行文件，使得 Python 程序可以在没有 Python 解释器的环境中运行。这对于希望将 Python 项目分发给没有安装 Python 的用户，或希望将程序打包成便捷的独立应用的开发者来说，是非常理想的解决方案。

PyInstaller 支持多平台（Windows、macOS、Linux），并且可以根据目标操作系统生成相应的可执行文件。本文将介绍 PyInstaller 的主要功能、使用方法，并通过一些示例展示如何打包 Python 项目为可执行文件。

💯 PyInstaller 的主要特点

1. 支持多平台

PyInstaller 支持将 Python 程序打包为 Windows、macOS 和 Linux 平台的可执行文件。这使得开发者可以通过同一个工具为不同操作系统的用户提供独立的可执行程序，而无需为每个系统单独编写代码。

2. 打包为单个文件

PyInstaller 允许将整个 Python 程序及其依赖项打包为一个单独的可执行文件。这种方式非常适合需要分发的应用程序，用户只需下载一个文件即可运行程序，而不需要担心依赖库的安装。

3. 处理复杂依赖项

PyInstaller 能够自动检测 Python 脚本的依赖项，并将这些依赖项打包在可执行文件中。这意味着即使你的项目使用了很多第三方库，PyInstaller 也能确保所有依赖项被正确包含在最终的可执行文件中。

4. 支持多种打包选项

PyInstaller 提供了多种打包选项，允许开发者根据项目的需要自定义打包过程。例如，可以选择生成单个文件、多个文件的目录结构，或者将数据文件和资源文件包含在包中。

5. 支持加密 Python 源代码

对于需要保护 Python 源代码的开发者，PyInstaller 还提供了加密 Python 字节码的选项，防止别人轻易反编译你的程序，增强了程序的安全性。

💯 安装 PyInstaller

PyInstaller 可以通过 pip 来轻松安装。只需在终端中运行以下命令即可完成安装：

pip install pyinstaller

安装完成后，你可以通过运行 pyinstaller --version 来确认安装成功。

💯 使用 PyInstaller 打包 Python 程序

1. 基本用法

要将一个 Python 脚本打包为可执行文件，只需在终端中运行以下命令：

pyinstaller your_script.py

运行上述命令后，PyInstaller 会自动生成适合当前操作系统的可执行文件。打包完成后，生成的文件将位于 dist 目录中，其中包含了所有必要的依赖项和资源。

2. 打包为单个可执行文件

默认情况下，PyInstaller 会生成一个目录，其中包含可执行文件和所有依赖项。如果你希望将所有文件打包为一个独立的可执行文件，可以使用 --onefile 选项：

pyinstaller --onefile your_script.py

打包完成后，dist 目录中会生成一个单独的可执行文件，用户可以直接运行这个文件，无需额外的依赖。

3. 包含数据文件

如果你的项目中包含了数据文件（如图片、配置文件等），可以通过 --add-data 选项将这些文件包含在打包过程中。例如，假设你的项目需要一个 config.json 文件：

pyinstaller --onefile --add-data "config.json:." your_script.py

在这个命令中，config.json 文件将被打包到最终的可执行文件中。需要注意的是，--add-data 选项的格式为 源文件路径:目标路径，其中目标路径是数据文件在程序运行时的相对位置。

4. 指定图标文件

PyInstaller 允许为生成的可执行文件指定自定义图标，特别是在生成 Windows 应用程序时非常有用。可以通过 --icon 选项指定图标文件：

pyinstaller --onefile --icon=app_icon.ico your_script.py

这样，打包后的可执行文件将使用你指定的图标。

5. 排除不必要的依赖项

在某些情况下，PyInstaller 可能会自动包含一些不需要的依赖项，增加了可执行文件的大小。可以通过 --exclude-module 选项排除特定的模块：

pyinstaller --onefile --exclude-module tkinter your_script.py

这样可以减小生成的可执行文件的体积，尤其是当你确定某些模块在程序中不会被使用时。

💯 高级功能

1. 使用 .spec 文件进行自定义打包

每次运行 PyInstaller 时，它都会生成一个 .spec 文件，其中包含打包过程的配置信息。你可以手动编辑这个文件来自定义打包过程，例如添加额外的数据文件、修改打包选项等。

一个简单的 .spec 文件示例如下：

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

block_cipher = None

a = Analysis(['your_script.py'],
             pathex=['/path/to/your/project'],
             binaries=[],
             datas=[('config.json', '.')],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=['tkinter'],
             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,
          [],
          exclude_binaries=True,
          name='your_script',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=True,
          console=True)

修改 .spec 文件后，可以通过以下命令使用自定义的打包配置：

pyinstaller your_script.spec

2. 打包带有 GUI 的应用程序

如果你的 Python 程序是一个图形用户界面（GUI）应用，可以通过 --noconsole 选项隐藏命令行窗口（特别是在 Windows 系统中）。例如，打包一个使用 PyQt 或 Tkinter 构建的 GUI 应用程序：

pyinstaller --onefile --noconsole your_gui_script.py

这样生成的可执行文件在启动时不会显示命令行窗口，给用户带来更好的体验。

3. 加密 Python 源代码

PyInstaller 提供了加密字节码的功能，帮助保护 Python 源代码。你可以通过 --key 选项指定加密密钥：

pyinstaller --onefile --key=mysecretkey your_script.py

这将加密 Python 的 .pyc 文件，防止他人轻易反编译你的代码。

💯 应用场景

1. 分发桌面应用程序：对于使用 Python 编写的桌面应用程序，PyInstaller 是打包并分发给最终用户的理想选择。无论用户是否安装了 Python 解释器，都可以通过 PyInstaller 生成的可执行文件直接运行应用程序。

2. 将脚本转换为独立工具：开发者可以通过 PyInstaller 将 Python 脚本打包成可执行文件，方便其他人使用这些脚本作为命令行工具或后台服务。

3. 保护源代码：通过加密字节码和打包为可执行文件，PyInstaller 可以帮助开发者保护其 Python 源代码，防止代码被反编译或篡改。

4. 跨平台开发：由于 PyInstaller 支持多平台打包，开发者可以使用它为不同操作系统的用户生成相应的可执行文件，减少跨平台发布的复杂性。

📥 下载地址

PyInstaller 最新版 下载地址

💬 结语

PyInstaller 是一个功能强大且灵活的 Python 打包工具，能够帮助开发者将 Python 脚本转换为独立的可执行文件。通过支持多平台打包、自动处理依赖、生成单个文件和加密源码，PyInstaller 极大简化了 Python 应用的分发过程。

无论是开发桌面应用程序、创建命令行工具，还是保护源代码，PyInstaller 都是一个非常值得使用的工具。如果你正在寻找一种简单高效的方式将 Python 程序打包为可执行文件，PyInstaller 是一个不二选择。

📒 参考文献

• PyInstaller 官网
• PyInstaller GitHub仓库