【Python实用技巧】用 PyInstaller 将 Python 脚本打包为 .exe 可执行文件

前言

• Python 是一门强大而灵活的编程语言，然而，在与非技术人员分享 Python 脚本时，他们可能不具备安装 Python 解释器的经验。为了方便共享和部署，我们可以将 Python 脚本打包为可执行文件（.exe），这样其他用户就无需安装 Python 环境，直接运行可执行文件即可。本文将介绍如何使用 PyInstaller 工具实现这一目标。

文末领取Python全套最新学习资源

PyInstaller

• PyInstaller是一个用于将Python脚本打包成独立可执行文件的工具。它的目标是方便地将Python应用程序分发给没有安装Python解释器的用户，使得Python脚本可以在没有Python环境的系统上运行。

特点

跨平台支持

• PyInstaller可以在Windows、Linux和MacOS等多个平台上运行，并生成相应平台的可执行文件。

自动依赖项处理

• PyInstaller会自动检测Python脚本的依赖项，并将它们打包到生成的可执行文件中。

单文件发布

• 使用–onefile选项，可以将所有的依赖项打包成一个单独的可执行文件，方便分发和部署。

支持图形用户界面（GUI）和命令行界面（CLI）应用

• PyInstaller适用于各种类型的Python应用，包括包含图形用户界面的桌面应用和命令行工具。

支持多种打包选项

• PyInstaller提供了许多命令行选项，允许用户灵活配置打包过程，例如指定可执行文件的名称、添加图标、手动添加依赖项等。

基本用法

shell
复制代码pyinstaller your_script.py

常用参数

• --onefile(-F): 将所有依赖项打包成一个单独的可执行文件。

shell
复制代码pyinstaller --onefile your_script.py

• --name your_custom_name: 指定生成的可执行文件的名称。

shell
复制代码pyinstaller --name your_custom_name your_script.py

• --icon=your_icon.ico: 指定生成的可执行文件的图标。图标文件通常是 .ico 格式。

shell
复制代码pyinstaller --onefile --icon=your_icon.ico your_script.py

• --hidden-import=module_name: 手动添加缺失的依赖项

shell
复制代码pyinstaller --onefile --requirements=requirements.txt your_script.py

• --requirements=requirements.txt: 指定包含依赖项列表的文件。

shell
复制代码pyinstaller --onefile --requirements=requirements.txt your_script.py

其它参数

shell复制代码--clean: 在打包前删除临时文件和输出目录。
--debug: 在调试模式下运行 PyInstaller。
--log-level: 指定日志级别，如 --log-level=DEBUG。
-w 是一个命令行选项，用于生成无控制台窗口的可执行文件。
-p 用于添加模块搜索路径。

版本 & 环境

• Python 2.7
• Windows 11 家庭中文版

实现步骤

安装 PyInstaller

• 首先确保你已经安装了 Python。然后，打开命令行或终端，并运行以下命令安装 PyInstaller：

shell
复制代码pip install pyinstaller

• 注意：由于本人使用的是 Python 2.7，Python 2.7 已经在2020年结束了官方支持。然而，PyInstaller 3.6.0 是最后一个官方宣布支持 Python 2.x 的版本。因此我们需要指定 PyInstaller的版本，否则会安装失败。

shell
复制代码pip install pyinstaller==3.6.0