make2/factory_sliceing/README_BUILD.md

打包说明

方法一：使用 Python 脚本打包（推荐）

Windows

python build_exe.py

打包后清理临时文件

python build_exe.py --clean

仅清理临时文件

python build_exe.py --clean-only

方法二：使用批处理文件（Windows）

直接双击运行 build_exe.bat 或在命令行执行：

build_exe.bat

方法三：手动使用 PyInstaller

# 安装 PyInstaller（如果未安装）
pip install pyinstaller

# 打包
pyinstaller --name=factory_sliceing --onefile --console --clean main.py

使用打包后的 exe

打包完成后，exe 文件位于 dist/factory_sliceing.exe

使用方法：

factory_sliceing.exe <command> <work_dir>

可用命令：

• batch_dwonload - 批量下载
• begin_sliceing - 开始切片
• download_zip - 下载压缩包

示例：

factory_sliceing.exe begin_sliceing C:\work\data

注意事项

1. 依赖项: 确保所有依赖已安装（redis, oss2, requests 等）
2. 隐藏导入: 如果运行时提示模块未找到，可以在 build_exe.py 中添加 --hidden-import 参数
3. 数据文件: 如果项目需要配置文件或其他数据文件，需要添加 --add-data 参数
4. 文件大小: 打包后的 exe 文件可能较大（通常 50-200MB），这是正常的，因为包含了 Python 解释器和所有依赖

故障排除

问题：打包后 exe 无法运行

• 检查是否所有依赖都已正确安装
• 尝试在命令行运行 exe 查看错误信息
• 检查是否有隐藏导入的模块未添加

问题：模块未找到错误

• 在 build_exe.py 中添加对应的 --hidden-import 参数
• 或者使用 --collect-all 参数收集所有子模块

问题：文件过大

• 这是正常的，PyInstaller 会打包 Python 解释器和所有依赖
• 可以使用 --exclude-module 排除不需要的模块来减小体积