PyInstaller打包工具（GUI界面版）PC版

软件说明

PyInstaller GUI 是一个图形化界面工具，用于简化 Python 脚本打包为可执行文件的过程。它基于 PyInstaller 构建，提供了直观的界面来配置各种打包选项，自动分析项目依赖，并支持多种高级功能。

主要功能

1. 项目设置- 选择主脚本和项目目录- 自动扫描项目文件结构- 依赖分析（静态分析、AST、pipreqs 等）

2. 构建选项- 单文件模式（–onefile）或单文件夹模式（–onedir）- 控制台/无控制台应用选择- 图标设置和预览- UPX 压缩配置

3. 依赖管理- 自动检测项目依赖- 选择性包含依赖- 一键安装依赖到临时环境

4. 包含内容- 添加数据文件（–add-data）- 添加二进制文件（–add-binary）- 指定隐藏导入（–hidden-import）- 设置 Python 路径（–paths）

5. 高级选项- 调试选项（–debug）- 优化级别设置（–optimize）- 元数据处理（–copy-metadata）- 排除模块（–exclude-module）

6. 平台特定设置- Windows：UAC 权限、版本文件、清单文件- macOS：Bundle 标识符、代码签名、权限文件

使用步骤

1. 配置项目- 在”项目设置”标签页选择主脚本文件（.py）- 设置项目目录（可选）- 点击”分析项目依赖”按钮扫描依赖

2. 管理依赖- 在依赖树中查看检测到的依赖- 使用”管理检测到的依赖”对话框选择要包含的依赖- 点击”安装依赖”将依赖安装到临时环境

3. 配置构建选项- 在”通用选项”设置输出路径和工作目录- 在”构建类型”选择单文件或单文件夹模式- 在”平台选项”配置应用图标和控制台行为

4. 添加额外内容- 在”包含内容”添加数据文件和二进制文件- 在”收集选项”配置子模块收集- 在”钩子选项”添加自定义钩子

5. 开始打包- 检查所有配置- 点击”开始打包”按钮- 在输出区域查看打包过程日志

常见问题解决

依赖未正确检测

1. 确保项目目录设置正确

2. 检查主脚本中是否有动态导入（可能需要手动添加到隐藏导入）

3. 使用”隐藏导入”列表手动添加缺失依赖

打包文件过大

1. 启用 UPX 压缩（确保已安装 UPX）

2. 启用剥离符号表选项（–strip）

3. 排除不必要的模块

打包后应用无法运行

1. 检查控制台输出是否有错误信息

2. 确保所有依赖已正确包含

3. 尝试在调试模式下打包（–debug all）

4. 检查平台特定设置（如 UAC 权限）

系统要求

Python 3.11+-、PyInstaller 6.0+-（推荐使用 64 位 Python 环境）

高级提示

1. 临时依赖环境- 工具会创建临时环境安装依赖，打包完成后自动清理- 可在打包前手动安装依赖到临时环境

2. 架构兼容性- 32 位 Python 无法打包 64 位应用- 64 位 Python 可打包 32 位应用（但可能不稳定）

3. 长命令处理- 当命令过长时，工具会自动使用响应文件- 在 Windows 上避免命令行长度限制问题

4. 日志级别- 可调整日志级别（TRACE 到 FATAL）以获取更多调试信息

5. 保存配置- 窗口关闭时会自动保存主要设置- 下次打开工具时会恢复上次配置

技术支持

如遇问题，请查看输出区域的错误信息，或通过以下方式获取帮助：

查看 PyInstaller 官方文档：https://pyinstaller.org/>

提示：对于复杂项目，建议先在命令行测试打包命令，再使用 GUI 工具配置。