build_instructions.md

构建EXE文件说明

环境要求

• Python 3.6+
• Windows 操作系统（用于构建Windows exe文件）

构建步骤

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

1. 在Windows上双击运行：

   build_exe.bat
   

2. 或者在命令行中运行：

   build_exe.bat

方法2：手动构建

1. 安装依赖：

   pip install -r requirements.txt

2. 运行PyInstaller：

   pyinstaller --clean pdf_password_remover.spec

3. 或者使用简单命令：

   pyinstaller --onefile --windowed --name "PDF密码移除器" pdf_password_remover.py

构建输出

• 构建成功后，exe文件位于 dist/ 文件夹中
• 文件名：PDF密码移除器.exe
• 文件大小：约15-30MB（包含所有依赖）

优化选项

减小文件大小

1. 使用UPX压缩（已在spec文件中启用）：

   • 需要先安装UPX：https://upx.github.io/
   • 可以将exe文件大小减小30-50%

2. 排除不必要的模块：

   • spec文件中已排除了常见的大型库（matplotlib, numpy等）

加快启动速度

1. 禁用控制台窗口：

   • spec文件中已设置 console=False

2. 使用--onefile选项：

   • 打包成单个exe文件，但启动会稍慢
   • 如需更快启动，可以使用--onedir选项

分发说明

1. 单文件分发：

   • 只需要分发 dist/PDF密码移除器.exe 文件
   • 用户无需安装Python即可运行

2. 兼容性：

   • 支持Windows 7及以上版本
   • 32位和64位Windows系统都支持

3. 安全提示：

   • 由于exe文件包含Python解释器，某些杀毒软件可能误报
   • 建议在构建前关闭杀毒软件或将项目文件夹添加到白名单

故障排除

常见问题

1. 模块导入错误：

   • 检查spec文件中的hiddenimports列表
   • 确保所有必需的模块都已包含

2. 文件过大：

   • 检查excludes列表，排除不必要的库
   • 考虑使用UPX压缩

3. 启动失败：

   • 在命令行中运行exe文件查看错误信息
   • 检查是否缺少必要的系统库

调试技巧

1. 启用调试模式：

   pyinstaller --debug=all pdf_password_remover.spec

2. 保留控制台：

   • 临时将spec文件中的console=False改为console=True
   • 可以看到详细的启动信息

版本信息

• PyInstaller版本：6.14.2
• Python版本：3.12+
• 支持的操作系统：Windows 7/8/10/11