PyInstaller GUI 打包工具。一个简化 PyInstaller 使用的图形界面工具,让 Python 应用程序打包变得更加简单直观。
下载
已打包好的程序及源码 (windows 可直接使用):
下载:https://hik.lanzouq.com/b0j0syj8j 密码:6w89
功能特性
🎯 核心功能
- 直观的图形界面 : 基于 Tkinter 构建,简洁易用
- 智能文件扫描 : 自动扫描项目目录下的 Python 文件
- 入口文件智能推荐 : 自动识别可能的程序入口文件
- 一键打包: 简化 PyInstaller 的复杂参数配置
⚙️ 参数配置
- -F (单文件模式): 生成单个可执行文件
- -w (无窗口模式): 隐藏控制台窗口
- 图标设置 : 为可执行文件设置自定义图标,选择 jpg/png 图片自动转 ico
- 数据文件包含 : 支持添加额外的数据文件
- 隐藏导入 : 指定需要隐藏导入的模块
- 构建选项: 清理旧文件、创建快捷方式、自动打开输出目录
📊 增强功能
- 实时构建日志 : 显示详细的打包过程和进度
- 构建历史记录 : 保存和查看历史打包记录
- 系统信息检查 : 显示 Python 和 PyInstaller 版本信息
- 磁盘空间检查 : 确保有足够空间进行打包
- 自动依赖安装 : 解析 requirements.txt 并安装依赖
- 配置持久化: 保存用户偏好设置
安装要求
系统要求
- Python 3.7+
- Windows/Linux/macOS
依赖包
pip install -r requirements.txt
主要依赖:
pyinstaller>=5.0.0
- 核心打包工具ttkthemes>=3.2.0
- 现代化主题(可选)send2trash>=1.8.0
- 安全文件删除(可选)
快速开始
1. 启动应用
python main.py
2. 基本使用流程
- 选择项目目录 : 点击”浏览”按钮选择包含 Python 代码的项目文件夹
- 选择入口文件 : 从下拉列表中选择程序的主入口文件
- 配置参数 : 根据需要勾选 PyInstaller 选项
- 开始打包 : 点击”一键生成 EXE”按钮
- 查看结果: 在日志区域查看打包进度,完成后会显示输出路径
3. 测试示例
项目包含一个示例应用程序 example_app.py
,可以用来测试打包功能:
- 选择当前项目目录
- 选择
example_app.py
作为入口文件 - 勾选需要的选项(建议勾选”-F”生成单文件)
- 点击打包按钮
详细功能说明
项目目录选择
- 支持选择包含 Python 源码的任意目录
- 自动扫描目录下的所有.py 文件(排除隐藏文件和缓存目录)
- 记住最后使用的目录路径
入口文件选择
- 智能推荐可能的入口文件(优先级:main.py > app.py > run.py 等)
- 支持选择任意.py 文件作为程序入口
- 自动验证选中文件的语法正确性
PyInstaller 参数配置
基本选项
- -F (单文件): 将所有依赖打包到单个 exe 文件中
- -w (无窗口): 适用于 GUI 应用,隐藏命令行窗口
高级选项
- 图标文件 : 支持.ico、.png 等格式,为 exe 设置自定义图标
- 数据文件 : 添加程序运行时需要的额外文件(如配置文件、资源文件等)
- 隐藏导入: 手动指定需要包含但可能被遗漏的模块
构建选项
- 构建前清理 : 自动删除之前的 build 和 dist 目录
- 创建快捷方式 : 在桌面创建可执行文件的快捷方式(仅 Windows)
- 打开输出目录: 构建完成后自动打开包含 exe 文件的目录
构建过程
- 环境检查 : 验证 PyInstaller 安装状态和系统环境
- 文件验证 : 检查入口文件语法和磁盘空间
- 依赖处理 : 自动安装 requirements.txt 中的依赖包
- 执行打包 : 调用 PyInstaller 进行实际打包
- 后处理: 创建快捷方式、打开输出目录等
历史记录
- 自动保存每次打包的详细信息
- 包括项目路径、入口文件、构建选项、成功状态等
- 支持查看和清除历史记录
- 最多保存 20 条记录
配置文件
应用程序会自动创建 config.json
配置文件,保存:
- 窗口大小和位置
- 最后使用的目录路径
- PyInstaller 默认参数
- 用户界面偏好设置
故障排除
常见问题
Q: PyInstaller 未安装怎么办?
A: 点击界面上的”安装 PyInstaller”按钮,或手动运行 pip install pyinstaller
Q: 打包失败,提示模块找不到?
A: 在”隐藏导入”框中添加缺失的模块名,多个模块用逗号分隔
Q: 生成的 exe 文件很大?
A: 这是正常现象,PyInstaller 会包含所有依赖。可以尝试使用虚拟环境减少不必要的依赖
Q: exe 文件运行时报错?
A: 检查是否需要添加数据文件,确保所有资源文件都已正确包含
调试技巧
- 查看详细的构建日志,了解具体错误信息
- 先不勾选”-w”选项,保留控制台窗口查看运行时错误
- 使用系统信息功能检查环境配置
- 确保项目在打包前能正常运行
技术架构
文件结构
PyInstaller-GUI/
├── main.py # 主程序入口
├── config.py # 配置管理模块
├── utils.py # 工具函数模块
├── requirements.txt # 依赖包列表
├── example_app.py # 示例应用程序
├── README.md # 项目说明文档
├── config.json # 用户配置文件(自动生成)
└── build_history.json # 构建历史记录(自动生成)
核心模块
- main.py: GUI 界面和主要业务逻辑
- config.py: 配置文件管理,支持持久化用户设置
- utils.py: 工具函数,包含 PyInstaller 操作、文件处理等
开发说明
扩展功能
如需添加新功能,可以:
- 在
utils.py
中添加工具函数 - 在
config.py
中添加新的配置项 - 在
main.py
中添加 UI 组件和业务逻辑
自定义主题
可以通过安装 ttkthemes
包来使用更多现代化主题:
from tkinter import ttk
from ttkthemes import ThemedTk, ThemedStyle
# 在 main 函数中替换
root = ThemedTk(theme="arc")
目录
下载
功能特性
- 🎯 核心功能
- ⚙️ 参数配置
- 📊 增强功能
安装要求
- 系统要求
- 依赖包
快速开始
- 1. 启动应用
- 2. 基本使用流程
- 3. 测试示例
详细功能说明
- 项目目录选择
- 入口文件选择
- PyInstaller 参数配置
- 基本选项
- 高级选项
- 构建选项
- 构建过程
- 历史记录
配置文件
故障排除
- 常见问题
- 调试技巧
技术架构
- 文件结构
- 核心模块
开发说明
- 扩展功能
- 自定义主题