PyInstaller 技术文档

1. 安装指南

1.1 系统要求

• Python: 3.8-3.13（不支持Python 3.10.0和Python 3.14的beta版本）
• Windows:
  • 支持Windows 7及以上版本，但官方仅支持Windows 8+。
  • 使用Windows商店安装的Python需要PyInstaller 4.4或更高版本。
• Linux:
  • 支持基于GNU libc和musl libc的多种架构（如x86_64, aarch64, i686, ppc64le, s390x）。
  • 需要ldd, objdump, objcopy等工具。
• macOS:
  • 支持macOS 10.15 (Catalina)及以上版本。
  • 支持构建universal2应用程序。

1.2 安装步骤

PyInstaller可以通过pip进行安装：

pip install pyinstaller

对于Raspberry Pi用户，建议添加piwheels作为额外的索引URL：

pip install pyinstaller --extra-index-url https://www.piwheels.org/simple

2. 项目的使用说明

2.1 基本用法

使用PyInstaller打包Python脚本非常简单，只需运行以下命令：

pyinstaller /path/to/yourscript.py

这将生成一个包含所有依赖项的单个文件夹或可执行文件。

2.2 高级选项

PyInstaller提供了多种选项来定制打包过程，例如：

• --onefile: 将所有内容打包到一个可执行文件中。
• --windowed: 创建一个无命令行窗口的应用程序（适用于GUI应用）。
• --icon=icon.ico: 为Windows应用程序设置图标。

更多详细信息，请参考官方手册。

3. 项目API使用文档

3.1 主要功能

PyInstaller的主要功能是将Python应用程序及其所有依赖项打包成一个独立的可执行文件或文件夹。它自动分析脚本所需的模块和库，并将它们与脚本一起打包。

3.2 支持的Python包

PyInstaller支持多种常见的Python包，如：

• numpy
• PyQt5, PySide2, PyQt6, PySide6
• wxPython
• matplotlib

3.3 第三方包支持

PyInstaller内置了多种第三方包的支持，用户无需额外配置即可使用这些包。

4. 项目安装方式

4.1 通过pip安装

最简单的安装方式是通过pip：

pip install pyinstaller

4.2 手动安装

对于某些平台，可能需要手动构建PyInstaller的引导程序。这通常在安装过程中自动完成，前提是系统中已安装了合适的C编译器（如gcc或clang）和zlib的开发头文件。

4.3 其他平台

对于未在官方测试范围内的平台（如FreeBSD, Solaris, AIX等），用户需要手动构建引导程序。具体步骤请参考官方文档。

5. 支持与帮助

5.1 官方调试指南

当遇到问题时，可以参考官方调试指南。

5.2 用户贡献的帮助主题

GitHub Wiki上提供了一些用户贡献的帮助主题，地址为GitHub Wiki。

5.3 社区支持

用户可以通过以下方式获取帮助：

• GitHub讨论区
• Google Groups

6. 版本变更

6.1 当前版本变更

当前版本的详细变更列表可以在Changelog中找到。

---

通过以上文档，用户可以了解如何安装、使用和调试PyInstaller，从而更好地打包Python应用程序。