介绍
auto-py-to-exe 是一个基于 PyInstaller 的可视化 Python 打包工具，把 .py 一键转成 Windows 独立 .exe，全程图形界面、无需手写命令，对新手非常友好。
特点
- 本质：PyInstaller 的 GUI 包装器，底层完全复用 PyInstaller 能力。
- 零命令：浏览器界面点选配置，自动生成并执行 PyInstaller 命令。
- 支持版本：Python 3.6–3.14，主流 32/64 位 Windows。
- 打包结果：
- 单文件（Onefile）：所有依赖打进一个 .exe，方便分发。
- 文件夹（Onedir）：exe + 依赖目录，启动更快、体积更小。
- 控制台/窗口模式：
- Console Based：保留黑框，适合命令行程序。
- Window Based：隐藏黑框，适合 GUI 程序（如 Tkinter/PyQt）。
- 附加功能：自定义 .ico 图标、追加资源文件、UPX 压缩、版本信息等。
安装
安装（需 Python 环境）
pip install auto-py-to-exe
启动
最常用
auto-py-to-exe
多 Python 版本时
python -m auto_py_to_exe
代码调用
import auto_py_to_exe
auto_py_to_exe.run()
启动后自动打开浏览器界面（默认 Chrome，无则用系统默认浏览器）。
界面与用法
- Script Location：点 Browse 选入口 .py（如 main.py），路径避免中文/空格。
- 基础配置
- Onefile：勾选=单文件；不勾选=目录模式。
- Console Window：GUI 选 Window Based，命令行选 Console Based。
- Icon：选 .ico 做程序图标（可选）。
- 附加文件（Additional Files）：添加图片/配置/数据文件，格式
源路径;目标目录。 - 高级选项（Advanced）
- UPX 压缩：显著减小体积（需安装 UPX）。
- 版本信息：设置公司、版本、版权。
- 自定义 PyInstaller 参数。
- 转换：点 Convert .py to .exe，完成后点 Open Output Folder 查看结果。
优缺点
- ✅ 优点
- 零门槛：纯可视化，新手直接上手。
- 配置直观：常用参数图形化，避免记命令。
- 兼容广泛：全平台、全 Python 版本，支持复杂依赖。
- ❌ 缺点
- 体积偏大：打包自带 Python 解释器，单文件常 50MB+。
- 杀毒误报：UPX 压缩或单文件模式易被报毒。
- 仅限 Windows：主要面向 Windows 打包（PyInstaller 可跨平台）。
常见问题
- 打包后闪退：
- 路径含中文 → 改用纯英文路径。
- 依赖缺失 → 在 Additional Files 补全资源。
- GUI 误选控制台 → 改为 Window Based。
- 文件太大：
- 用 Onedir 模式；开启 UPX 压缩；虚拟环境打包减少冗余依赖。
与 PyInstaller 对比
- auto-py-to-exe：GUI、易上手、适合快速打包；底层同 PyInstaller。
- PyInstaller：命令行、灵活、适合脚本集成/自动化；需记忆参数。
总结
auto-py-to-exe 是新手打包 Python 程序的最佳选择，用图形界面屏蔽复杂命令，一键生成独立 exe，适合快速交付工具、GUI 应用或小脚本。