PyInstaller入门：打造跨平台独立的可执行程序

将 Python 脚本轻松打包成独立程序：PyInstaller 指南

简介

对于希望将 Python 脚本变为独立程序的开发者来说，PyInstaller 是一个必备工具。通过 PyInstaller，你可以轻而易举地将脚本编译成跨平台的可执行文件，无需安装 Python 解释器。本文将深入探讨 PyInstaller，从安装到基本和高级用法，一步步指导你将其融入你的 Python 开发流程。

安装 PyInstaller

安装 PyInstaller 非常简单。你可以从官方网站下载它，或使用 pip 命令：

pip install pyinstaller

基本用法

PyInstaller 的基本用法很简单。只需一条命令即可将你的 Python 脚本打包成可执行程序：

pyinstaller --onefile --windowed my_script.py

• --onefile 选项将所有文件打包成一个可执行文件。
• --windowed 选项创建带窗口的可执行程序。
• my_script.py 是你需要打包的 Python 脚本。

执行此命令后，PyInstaller 将开始打包你的脚本，并在当前目录生成一个可执行程序文件。

高级用法

除了基本用法，PyInstaller 还提供了丰富的选项，让你对打包过程进行更精细的控制。

• 指定图标： 使用 --icon 选项指定可执行程序的图标。
• 指定版本号： 使用 --version 选项指定可执行程序的版本号。
• 指定名称： 使用 --name 选项指定可执行程序的名称。
• 排除文件： 使用 --exclude-module 选项排除不需要打包的文件。
• 包含数据文件： 使用 --add-data 选项包含脚本所需的数据文件。

有关 PyInstaller 高级用法的更多信息，请参阅其官方文档。

示例：打包带 GUI 的脚本

让我们通过一个示例来看看如何使用 PyInstaller 打包带 GUI 的 Python 脚本。

# my_script.py

import tkinter as tk

def main():
    root = tk.Tk()
    root.title("My Script")
    root.mainloop()

if __name__ == "__main__":
    main()

要将此脚本打包成可执行程序，请使用以下命令：

pyinstaller --onefile --windowed --icon=my_icon.ico my_script.py

这将生成一个包含 GUI 的独立可执行程序。

结论

PyInstaller 是一个强大的工具，可以将你的 Python 脚本转换成独立的、跨平台的可执行程序。通过本指南，你已经掌握了它的基本和高级用法，可以轻松地将你的脚本变为独立应用程序。

常见问题解答

1. PyInstaller 可以打包所有 Python 脚本吗？
   • 否，PyInstaller 无法打包依赖于 C 扩展的脚本。
2. 如何打包依赖于第三方库的脚本？
   • 使用 --hidden-import 选项指定需要打包的第三方库。
3. 如何打包包含外部数据的脚本？
   • 使用 --add-data 选项包含外部数据文件。
4. 如何自定义打包的可执行程序？
   • 使用 --specpath 选项指定一个配置文件，其中包含自定义打包设置。
5. 哪里可以找到有关 PyInstaller 的更多信息？
   • PyInstaller 官方文档是获取详细信息的最佳资源。