本文共 1180 字，大约阅读时间需要 3 分钟。

PyInstaller 使用指南：打包 Python 项目的完整指南

PyInstaller 是一个强大的工具，可以帮助你将 Python 项目打包成可执行文件。本文将详细指导如何使用 PyInstaller，包括安装、打包选项以及优化技巧。

1. 安装 PyInstaller

首先，确保你已经安装了必要的工具。可以通过以下命令安装 PyInstaller：

pip install pyinstaller -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com

注意：--trusted-host pypi.douban.com 可以帮助你绕过 SSL 证书验证问题。

2. 打包选项解析

在使用 PyInstaller 时，以下是一些常用选项：

• -F：生成单个可执行文件。通常用于 GUI 应用程序。
• -w：去掉控制台窗口。这对于 GUI 应用非常有用，但如果是命令行工具，可以选择不使用。
• -i：指定可执行文件的图标。
• --onefile：与 -F 等效，用于生成单一文件。
• --noconsole：隐藏控制台输出。

例如，打包一个简单的 GUI 应用 test.py 可能如下：

pyinstaller -F -w test.py

3. 依赖管理

PyInstaller 会自动处理你的项目依赖，但为了更好地优化打包文件大小，建议采取以下措施：

• 尽量使用 from importlib.util import module_name 代替 import module_name。
• 对于第三方库，优先使用 from ... import ... 格式，而不是直接 import ...。

这可以显著减少打包文件的大小。

4. 注意事项

• 如果你的项目包含多个文件（如多个 Python 文件），不要使用 -F 选项。
• 打包前，确保所有依赖都已安装在当前环境中。
• 如果打包后的文件异常大，可能需要检查 pyinstaller 的依赖管理选项。

5. 常用库版本

• PyInstaller：3.4
• pywin32：224
• PyQt5：5.11.3

这些库版本是 PyInstaller 支持的常见版本，建议与项目兼容性确认。

6. PyInstaller 选项详解

如果需要了解更多选项，可以通过以下命令查看帮助文档：

pyinstaller -h

7. 其他优化建议

• 打包前检查环境是否满足所有依赖。
• 如果项目文件较多，可以尝试使用 -F 选项，但需确保依赖处理正确。
• 对于 GUI 应用，建议使用 -w 选项。

通过以上方法，你可以更高效地使用 PyInstaller 将 Python 项目打包成可执行文件。如果有更多疑问，可以参考 PyInstaller 的官方文档或社区资源。

转载地址：http://ofafk.baihongyu.com/