python 打包工具 auto-py-to-exe 介绍-马育民老师

# 介绍

**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