# 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模式)