🚢 Python PyInstaller 安装和使用教程

Python PyInstaller 安装和使用教程

1. 简介

PyInstaller 是一个用于将 Python 脚本打包成独立可执行文件的工具。它支持 Windows、Linux 和 macOS 等多个平台，并且可以将 Python 脚本打包成单个可执行文件或包含多个文件的目录。PyInstaller 的主要优点是它可以将 Python 脚本及其依赖项打包成一个独立的可执行文件，使得用户无需安装 Python 解释器即可运行程序。

本教程将详细介绍如何安装 PyInstaller 并使用它来打包 Python 脚本。我们还将介绍一些常用的 PyInstaller 选项，帮助你更好地控制打包过程。

2. 安装 PyInstaller

在开始使用 PyInstaller 之前，首先需要安装它。你可以使用 pip 来安装 PyInstaller。

2.1 使用 pip 安装 PyInstaller

打开命令行工具（Windows 上的命令提示符或 PowerShell，Linux 和 macOS 上的终端），然后运行以下命令：

pip install pyinstaller

安装完成后，你可以通过以下命令来验证 PyInstaller 是否安装成功：

pyinstaller --version

如果安装成功，命令行将显示 PyInstaller 的版本号。

2.2 升级 PyInstaller

如果你已经安装了 PyInstaller，但想要升级到最新版本，可以使用以下命令：

pip install --upgrade pyinstaller

3. 使用 PyInstaller 打包 Python 脚本

PyInstaller 的使用非常简单，只需在命令行中运行 pyinstaller 命令并指定要打包的 Python 脚本即可。下面我们将通过一个简单的例子来演示如何使用 PyInstaller 打包 Python 脚本。

3.1 创建一个简单的 Python 脚本

首先，我们创建一个简单的 Python 脚本 hello.py，内容如下：

# hello.py
print("Hello, PyInstaller!")

3.2 使用 PyInstaller 打包脚本

在命令行中，导航到包含 hello.py 的目录，然后运行以下命令：

pyinstaller hello.py

PyInstaller 将开始分析脚本并打包。打包完成后，你会在当前目录下看到两个新文件夹：build 和 dist。

• build 文件夹包含 PyInstaller 在打包过程中生成的临时文件。
• dist 文件夹包含打包后的可执行文件。

在 dist 文件夹中，你会找到一个与脚本同名的可执行文件（例如 hello.exe）。你可以直接运行这个可执行文件来执行你的 Python 脚本。

3.3 打包成单个可执行文件

默认情况下，PyInstaller 会将脚本打包成一个包含多个文件的目录。如果你希望将脚本打包成单个可执行文件，可以使用 -F 或 --onefile 选项：

pyinstaller -F hello.py

打包完成后，dist 文件夹中将只包含一个单独的可执行文件。

3.4 打包成目录

如果你希望将脚本打包成一个目录（包含多个文件），可以使用 -D 或 --onedir 选项：

pyinstaller -D hello.py

这是 PyInstaller 的默认行为，因此你也可以省略 -D 选项。

4. 常用 PyInstaller 选项

PyInstaller 提供了许多选项来控制打包过程。下面是一些常用的选项：

4.1 查看帮助信息

如果你不确定如何使用某个选项，可以使用 -h 或 --help 选项来查看 PyInstaller 的帮助信息：

pyinstaller -h

4.2 不包含 Unicode 字符集支持

如果你不需要 Unicode 字符集支持，可以使用 -a 或 --ascii 选项：

pyinstaller -a hello.py

4.3 生成调试版本的可执行文件

如果你需要调试打包后的可执行文件，可以使用 -d 或 --debug 选项来生成调试版本：

pyinstaller -d hello.py

4.4 不显示命令行窗口（仅限 Windows）

在 Windows 上，默认情况下，打包后的可执行文件会显示一个命令行窗口。如果你不希望显示命令行窗口，可以使用 -w 或 --windowed 选项：

pyinstaller -w hello.py

4.5 使用命令行窗口运行程序（仅限 Windows）

如果你希望打包后的可执行文件使用命令行窗口运行程序，可以使用 -c 或 --console 选项：

pyinstaller -c hello.py

4.6 指定输出目录

你可以使用 -o DIR 或 --out=DIR 选项来指定 spec 文件的生成目录。如果没有指定，则默认使用当前目录来生成 spec 文件：

pyinstaller -o ./output hello.py

4.7 设置 Python 导入模块的路径

如果你需要指定 Python 导入模块的路径，可以使用 -p DIR 或 --path=DIR 选项。你可以使用路径分隔符（Windows 使用分号，Linux 使用冒号）来分隔多个路径：

pyinstaller -p ./lib1 -p ./lib2 hello.py

4.8 指定项目名字

你可以使用 -n NAME 或 --name=NAME 选项来指定项目的名字。如果省略该选项，那么第一个脚本的主文件名将作为 spec 的名字：

pyinstaller -n myapp hello.py

5. 高级用法

除了上述常用选项外，PyInstaller 还支持许多高级功能，例如自定义 spec 文件、打包数据文件、处理隐藏导入等。如果你有更复杂的需求，可以参考 PyInstaller 的官方文档来了解更多高级用法。

6. 总结

PyInstaller 是一个非常强大的工具，可以帮助你将 Python 脚本打包成独立的可执行文件。通过本教程，你应该已经掌握了 PyInstaller 的基本用法，并了解了一些常用的选项。希望这篇教程能帮助你更好地使用 PyInstaller 来打包和分发你的 Python 程序。

如果你有任何问题或建议，欢迎在评论区留言！