yuuko
88d9df8961
- 新增Excel表头转换工具的可执行文件 - 添加打包说明文档，包含一键打包和手动打包方法 - 添加README文档说明工具功能和使用方法 - 包含转换规则、安装要求和使用注意事项 - 添加requirements.txt指定依赖版本 - 包含build.spec打包配置文件
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模式） |