Python打包工具 Pyinstaller使用教程

### PyInstaller 使用教程 PyInstaller 是一个将 Python 脚本打包为独立可执行文件的工具，支持 Windows、macOS 和 Linux 平台。以下是关于如何使用 PyInstaller 打包 Python 程序的详细说明[^1]。 #### 安装 PyInstaller 在开始之前，需要确保系统中已安装 PyInstaller。可以通过以下命令安装： ```bash pip install pyinstaller ``` 如果需要更新到最新版本，可以使用以下命令： ```bash pip install --upgrade pyinstaller ``` #### 基本用法 假设有一个名为 `main.py` 的 Python 脚本，可以通过以下命令将其打包为单个可执行文件： ```bash pyinstaller --onefile main.py ``` 上述命令会生成一个单独的可执行文件，位于 `dist` 文件夹中[^2]。 #### 高级选项 - **指定输出文件名**：可以使用 `--name` 参数指定生成的可执行文件名称。 ```bash pyinstaller --onefile --name=my_program main.py ``` - **隐藏控制台窗口**：对于 GUI 应用程序，可以使用 `--noconsole` 参数隐藏控制台窗口。 ```bash pyinstaller --onefile --noconsole main.py ``` - **添加图标**：可以通过 `--icon` 参数为生成的可执行文件添加自定义图标。 ```bash pyinstaller --onefile --icon=icon.ico main.py ``` #### 处理依赖项 如果脚本依赖于外部文件（如图片或配置文件），可以使用 `--add-data` 参数将这些文件包含在打包中。注意，在不同平台上路径分隔符可能有所不同，因此需要根据操作系统调整路径格式。 ```bash pyinstaller --onefile --add-data "img/python-logo.png;img" main.py ``` 在代码中访问这些文件时，需要使用 `sys._MEIPASS` 来定位资源文件的位置[^5]。 #### 示例代码 以下是一个简单的示例代码，展示了如何创建一个带有图片的 GUI 程序，并将其打包为可执行文件。 ```python import tkinter as tk from tkinter import PhotoImage import os import sys def resource_path(relative_path): try: base_path = sys._MEIPASS except Exception: base_path = os.path.abspath(".") return os.path.join(base_path, relative_path) if __name__ == "__main__": root = tk.Tk() root.title('Python Logo Example') root.geometry('600x600') root.configure(background='#1e1e1e') python_logo = PhotoImage(file=resource_path('img/python-logo.png')) label = tk.Label(root, text='Python Logo', bg='#333', image=python_logo) label.pack(side=tk.TOP, fill=tk.BOTH, expand=True) root.mainloop() ``` #### 打包过程中的调试 如果在运行生成的可执行文件时遇到问题，可以通过命令行运行该文件以查看错误信息。例如： ```bash dist\my_program.exe ``` 此外，可以使用 `--debug=all` 参数以调试模式运行程序，从而捕获更多详细信息[^4]。 ---