Python程序打包工具

一个功能强大的图形界面工具，用于将Python脚本和项目轻松打包为可执行文件(EXE)，无需复杂的命令行操作。

功能特点

🎯 灵活的打包模式

• 单文件打包：直接将单个Python脚本打包成可执行文件
• 项目文件夹打包：支持整个Python项目的打包，自动检测入口文件

🛠️ 丰富的配置选项

• 隐藏终端窗口：适合GUI应用程序，避免黑色命令窗口显示
• 打包格式选择：支持单文件(--onefile)或文件夹(--onedir)格式
• 自定义图标：支持.ico、.png、.jpg等多种格式图标，自动转换非ICO格式

🌐 智能依赖处理

• 虚拟环境支持：自动检测并使用项目的虚拟环境依赖
• 自动导入检测：智能分析Python文件中的导入模块，自动添加hidden imports
• 自定义hidden imports：支持手动添加必要的模块导入
• 自动安装PyInstaller：如果系统未安装PyInstaller，程序会自动检测并安装

📊 友好的用户界面

• 实时进度显示：打包过程可视化，提供进度条和状态更新
• 终端输出捕获：实时显示打包过程中的所有输出信息
• 折叠面板设计：将高级选项分类展示，保持界面简洁

安装要求

• Python 3.6 或更高版本
• 以下Python库：
  • tkinter (通常随Python一起安装)
  • PyInstaller (核心打包库)
  • Pillow (用于图标转换)

安装方法

1. 确保已安装Python环境
2. 安装必要的依赖：

   pip install pyinstaller pillow
   

3. 下载本项目的py_to_exe_gui.py文件

使用说明

基本使用流程

1. 运行程序：

   python py_to_exe_gui.py
   

2. 选择打包模式：

   • 单文件模式：选择一个Python脚本文件(.py)
   • 项目模式：选择项目文件夹和入口Python文件

3. 选择输出目录：指定打包结果的保存位置

4. 配置高级选项（可选）：

   • 展开"高级选项"面板进行配置
   • 展开"虚拟环境设置"面板配置虚拟环境
   • 展开"Hidden Imports 设置"面板配置导入模块

5. 点击"开始打包"：等待打包完成

常见问题解答

为什么需要设置虚拟环境？

使用虚拟环境可以确保打包的应用包含所有必要的依赖，避免运行时缺少模块的问题。

为什么需要设置Hidden Imports？

有些Python模块使用动态导入，PyInstaller可能无法自动检测到。通过添加hidden imports，可以确保这些模块被正确打包。

打包后程序运行出错怎么办？

检查终端输出窗口中的错误信息，通常可以帮助诊断问题。常见问题包括缺少依赖、路径错误等。

注意事项

• 对于大型项目，打包过程可能需要较长时间
• 某些第三方库可能需要特殊处理才能正确打包
• 对于有GUI界面的程序，建议选择"隐藏终端窗口"选项
• 打包生成的可执行文件通常比原始Python脚本大很多，这是正常现象

开发说明

本工具基于以下技术：

• Tkinter：创建图形用户界面
• PyInstaller：核心打包功能
• Pillow：图像格式转换
• 多线程：确保打包过程不会冻结界面

许可证

本项目采用MIT许可证 - 查看LICENSE文件获取详情

贡献

欢迎提交Issue和Pull Request来帮助改进这个工具！

作者

kute - 3846415473@qq.com