table-replacer/打包说明.md

Excel表头转换工具 - 打包说明

🚀 一键打包

方法1：使用批处理文件（推荐）

1. 双击运行 build.bat
2. 等待打包完成
3. 在 dist 文件夹中找到 Excel表头转换工具.exe

方法2：手动打包

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