PyInstaller 一键打包 python 脚本成 exe 工具

PyInstaller GUI 打包工具。一个简化 PyInstaller 使用的图形界面工具,让 Python 应用程序打包变得更加简单直观。

null

下载

已打包好的程序及源码 (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. 基本使用流程

  1. 选择项目目录 : 点击”浏览”按钮选择包含 Python 代码的项目文件夹
  2. 选择入口文件 : 从下拉列表中选择程序的主入口文件
  3. 配置参数 : 根据需要勾选 PyInstaller 选项
  4. 开始打包 : 点击”一键生成 EXE”按钮
  5. 查看结果: 在日志区域查看打包进度,完成后会显示输出路径

3. 测试示例

项目包含一个示例应用程序 example_app.py,可以用来测试打包功能:

  1. 选择当前项目目录
  2. 选择 example_app.py 作为入口文件
  3. 勾选需要的选项(建议勾选”-F”生成单文件)
  4. 点击打包按钮

详细功能说明

项目目录选择

  • 支持选择包含 Python 源码的任意目录
  • 自动扫描目录下的所有.py 文件(排除隐藏文件和缓存目录)
  • 记住最后使用的目录路径

入口文件选择

  • 智能推荐可能的入口文件(优先级:main.py > app.py > run.py 等)
  • 支持选择任意.py 文件作为程序入口
  • 自动验证选中文件的语法正确性

PyInstaller 参数配置

基本选项

  • -F (单文件): 将所有依赖打包到单个 exe 文件中
  • -w (无窗口): 适用于 GUI 应用,隐藏命令行窗口

高级选项

  • 图标文件 : 支持.ico、.png 等格式,为 exe 设置自定义图标
  • 数据文件 : 添加程序运行时需要的额外文件(如配置文件、资源文件等)
  • 隐藏导入: 手动指定需要包含但可能被遗漏的模块

构建选项

  • 构建前清理 : 自动删除之前的 build 和 dist 目录
  • 创建快捷方式 : 在桌面创建可执行文件的快捷方式(仅 Windows)
  • 打开输出目录: 构建完成后自动打开包含 exe 文件的目录

构建过程

  1. 环境检查 : 验证 PyInstaller 安装状态和系统环境
  2. 文件验证 : 检查入口文件语法和磁盘空间
  3. 依赖处理 : 自动安装 requirements.txt 中的依赖包
  4. 执行打包 : 调用 PyInstaller 进行实际打包
  5. 后处理: 创建快捷方式、打开输出目录等

历史记录

  • 自动保存每次打包的详细信息
  • 包括项目路径、入口文件、构建选项、成功状态等
  • 支持查看和清除历史记录
  • 最多保存 20 条记录

配置文件

应用程序会自动创建 config.json 配置文件,保存:

  • 窗口大小和位置
  • 最后使用的目录路径
  • PyInstaller 默认参数
  • 用户界面偏好设置

故障排除

常见问题

Q: PyInstaller 未安装怎么办?
A: 点击界面上的”安装 PyInstaller”按钮,或手动运行 pip install pyinstaller

Q: 打包失败,提示模块找不到?
A: 在”隐藏导入”框中添加缺失的模块名,多个模块用逗号分隔

Q: 生成的 exe 文件很大?
A: 这是正常现象,PyInstaller 会包含所有依赖。可以尝试使用虚拟环境减少不必要的依赖

Q: exe 文件运行时报错?
A: 检查是否需要添加数据文件,确保所有资源文件都已正确包含

调试技巧

  1. 查看详细的构建日志,了解具体错误信息
  2. 先不勾选”-w”选项,保留控制台窗口查看运行时错误
  3. 使用系统信息功能检查环境配置
  4. 确保项目在打包前能正常运行

技术架构

文件结构

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 操作、文件处理等

开发说明

扩展功能

如需添加新功能,可以:

  1. utils.py 中添加工具函数
  2. config.py 中添加新的配置项
  3. main.py 中添加 UI 组件和业务逻辑

自定义主题

可以通过安装 ttkthemes 包来使用更多现代化主题:

from tkinter import ttk
from ttkthemes import ThemedTk, ThemedStyle

# 在 main 函数中替换
root = ThemedTk(theme="arc")
目录
  • 下载
  • 功能特性
    • 🎯 核心功能
    • ⚙️ 参数配置
    • 📊 增强功能
  • 安装要求
    • 系统要求
    • 依赖包
  • 快速开始
    • 1. 启动应用
    • 2. 基本使用流程
    • 3. 测试示例
  • 详细功能说明
    • 项目目录选择
    • 入口文件选择
    • PyInstaller 参数配置
      • 基本选项
      • 高级选项
      • 构建选项
    • 构建过程
    • 历史记录
  • 配置文件
  • 故障排除
    • 常见问题
    • 调试技巧
  • 技术架构
    • 文件结构
    • 核心模块
  • 开发说明
    • 扩展功能
    • 自定义主题
  • 本文标题:《PyInstaller 一键打包 python 脚本成 exe 工具》作者:极四维博客
    原文链接:https://cway.top/post/1140.html
    特别注明外均为原创,转载请注明。

    分享到微信

    扫描二维码

    可在微信查看或分享至朋友圈。

    相关文章

    发表评论:

    ◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。

    «    2025年8月    »
    123
    45678910
    11121314151617
    18192021222324
    25262728293031

    搜索

    控制面板

    您好,欢迎到访网站!
      查看权限

    最新留言

    文章归档

    • 订阅本站的 RSS 2.0 新闻聚合