63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
|
# Excel表头转换工具 - 打包说明
|
|||
|
|
|
|||
|
|
## 🚀 一键打包
|
|||
|
|
|
|||
|
|
### 方法1：使用批处理文件（推荐）
|
|||
|
|
1. 双击运行 `build.bat`
|
|||
|
|
2. 等待打包完成
|
|||
|
|
3. 在 `dist` 文件夹中找到 `Excel表头转换工具.exe`
|
|||
|
|
|
|||
|
|
### 方法2：手动打包
|
|||
|
|
```bash
|
|||
|
|
# 1. 安装依赖
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
|
|||
|
|
# 2. 打包程序
|
|||
|
|
pyinstaller build.spec
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📦 打包特性
|
|||
|
|
|
|||
|
|
### ✅ 兼容性优化
|
|||
|
|
- **支持Win7及以上系统**
|
|||
|
|
- **无需安装Python环境**
|
|||
|
|
- **自动包含所有依赖库**
|
|||
|
|
- **单文件可执行程序**
|
|||
|
|
|
|||
|
|
### 🔧 技术优化
|
|||
|
|
- 使用 `data_only=True` 正确处理Excel公式
|
|||
|
|
- 添加 `sys._MEIPASS` 支持打包后的资源路径
|
|||
|
|
- 优化错误处理，避免打包后崩溃
|
|||
|
|
- 移除不必要的依赖（tkinter是Python内置库）
|
|||
|
|
|
|||
|
|
### 📁 输出结构
|
|||
|
|
```
|
|||
|
|
dist/
|
|||
|
|
└── Excel表头转换工具.exe # 可执行文件（约15-20MB）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🎯 使用说明
|
|||
|
|
|
|||
|
|
### 打包后的程序特点：
|
|||
|
|
1. **独立运行**：无需安装Python或任何依赖
|
|||
|
|
2. **兼容性强**：支持Windows 7/8/10/11
|
|||
|
|
3. **体积优化**：使用UPX压缩，减小文件大小
|
|||
|
|
4. **错误处理**：完善的异常处理，避免程序崩溃
|
|||
|
|
|
|||
|
|
### 分发建议：
|
|||
|
|
- 可以直接复制 `.exe` 文件到目标电脑
|
|||
|
|
- 建议同时提供使用说明文档
|
|||
|
|
- 首次运行可能被杀毒软件拦截，添加信任即可
|
|||
|
|
|
|||
|
|
## 🛠️ 故障排除
|
|||
|
|
|
|||
|
|
### 常见问题：
|
|||
|
|
1. **打包失败**：确保已安装所有依赖 `pip install -r requirements.txt`
|
|||
|
|
2. **运行报错**：检查目标系统是否为Windows 7及以上
|
|||
|
|
3. **杀毒软件拦截**：将程序添加到杀毒软件白名单
|
|||
|
|
|
|||
|
|
### 技术细节：
|
|||
|
|
- 使用PyInstaller 5.13.2版本（兼容性最佳）
|
|||
|
|
- 启用UPX压缩减小文件体积
|
|||
|
|
- 隐式导入所有必要的openpyxl模块
|
|||
|
|
- 禁用控制台窗口（GUI模式）
|