python 打包工具 auto-py-to-exe 介绍 作者:马育民 • 2026-06-08 15:47 • 阅读:10006 # 介绍 **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 环境) ```bash pip install auto-py-to-exe ``` # 启动 ### 最常用 ```bash auto-py-to-exe ``` ### 多 Python 版本时 ``` python -m auto_py_to_exe ``` ### 代码调用 ``` import auto_py_to_exe auto_py_to_exe.run() ``` 启动后自动打开浏览器界面(默认 Chrome,无则用系统默认浏览器)。 # 界面与用法 1. **Script Location**:点 Browse 选入口 .py(如 main.py),路径**避免中文/空格**。 2. **基础配置** - Onefile:勾选=单文件;不勾选=目录模式。 - Console Window:GUI 选 Window Based,命令行选 Console Based。 - Icon:选 .ico 做程序图标(可选)。 3. **附加文件(Additional Files)**:添加图片/配置/数据文件,格式 `源路径;目标目录`。 4. **高级选项(Advanced)** - UPX 压缩:显著减小体积(需安装 UPX)。 - 版本信息:设置公司、版本、版权。 - 自定义 PyInstaller 参数。 5. **转换**:点 **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 应用或小脚本。 原文出处:http://malaoshi.top/show_1GW3SYIlI0yI.html