将 Python 程序打包成可执行 EXE 文件的终极指南

2023-12-04 06:46:49

PyInstaller：将 Python 脚本转换为独立应用程序的利器

在 Python 开发中，经常需要将脚本打包成独立的应用程序以便分发、销售或用于自动化。PyInstaller 是一个功能强大的第三方库，专为将 Python 程序转换为 EXE 文件而设计。本指南将深入介绍 PyInstaller 的工作原理，并提供详细的分步教程，帮助你轻松打包 Python 程序。

安装 PyInstaller

要使用 PyInstaller，你需要先安装它。有两种方法：

使用 pip： 在终端或命令提示符中输入以下命令：pip install pyinstaller
使用 Anaconda： 在 Anaconda Navigator 中，导航到环境选项卡，选择你的 Python 环境，搜索 "PyInstaller" 并单击 "安装" 按钮。

安装完成后，运行 pyinstaller 命令来验证是否安装成功。你会看到如下输出：

usage: pyinstaller [options] <script> [script] ...

打包 Python 程序

要将 Python 程序打包成 EXE 文件，请按照以下步骤操作：

打开终端或命令提示符： 导航到存放 Python 脚本的目录。
输入以下命令：
```
pyinstaller --onefile --windowed your_script.py
```
- --onefile 选项将所有必要的资源打包到单个可执行文件中。
- --windowed 选项指定程序在窗口模式下运行（适用于 GUI 应用程序）。
等待打包完成： PyInstaller 将处理依赖项、编译脚本并生成可执行文件。

示例代码

以下是一个简单的 Python 脚本，用于在 GUI 窗口中显示 "Hello World"：

import tkinter as tk

# 创建主窗口
root = tk.Tk()
root.title("Hello World")

# 创建标签控件
label = tk.Label(root, text="Hello World!")
label.pack()

# 启动应用程序循环
root.mainloop()

要将这个脚本打包成 EXE 文件，请按照上述步骤操作，并将 your_script.py 替换为 hello_world.py。

解决常见问题

在打包 Python 程序时，你可能会遇到以下常见问题：

缺少依赖项： 确保所有需要的库都已安装。使用 pip freeze 命令检查已安装的库。
图标缺失： 如果需要添加图标，请在脚本目录中创建一个名为 icon.ico 的 ICO 文件。然后使用 --icon 选项指定它：pyinstaller --onefile --windowed --icon icon.ico hello_world.py
在 Mac 上无法运行： 在 Mac 上打包 Python 程序时，你需要指定目标平台：pyinstaller --onefile --windowed --target app hello_world.py