Python GUI 应用程序打包成可执行 EXE 文件指南

简介

要将您的 Python GUI 应用程序打包成可执行的 EXE 文件，推荐使用 PyInstaller 工具。以下是详细步骤与注意事项。

1. 安装 PyInstaller

确保已安装 PyInstaller：

pip install pyinstaller

2. 准备打包命令

以下是打包命令，包含必要的参数以处理 Tkinter GUI 应用及依赖：

pyinstaller --onefile --windowed --add-data "你的 Python 路径/Lib/tkinter;tkinter" --add-data "你的 Python 路径/Lib/site-packages/PyPDF2;PyPDF2" pdf_metadata_viewer.py

重要说明：

1. 替换 Python 路径：将 你的 Python 路径 替换为您的实际 Python 安装路径（例如 C:/Python39）。可通过运行 where python 查看路径。
2. --windowed 参数：确保 GUI 应用不显示控制台窗口。
3. --add-data 参数：确保包含 Tkinter 和 PyPDF2 等依赖包。注意 Windows 下分隔符为分号 ;。
4. 文件名：最后的 pdf_metadata_viewer.py 为您要打包的脚本文件。

3. 常见问题处理

问题 1：找不到 tkinter

如果出现 ModuleNotFoundError: No module named 'tkinter' 错误，请检查是否添加了正确的 --add-data 路径。

问题 2：找不到 PyPDF2

如果出现 ModuleNotFoundError: No module named 'PyPDF2' 错误，请确保在命令中正确指定了该模块的路径。

问题 3：路径问题（Windows）

如果路径包含空格，请使用双引号包裹路径：

pyinstaller --onefile --windowed --add-data "C:/Program Files/Python39/Lib/tkinter;tkinter" pdf_metadata_viewer.py

4. 验证与清理

找到生成的 EXE 文件

打包完成后，EXE 文件位于 dist 目录下：

dist/pdf_metadata_viewer.exe

测试打包结果

1. 运行生成的 EXE 文件。
2. 确认可以正常选择 PDF 文件并查看元数据。
3. 尝试保存为文本文件。

附加建议

• 添加图标（可选）：

  pyinstaller --onefile --windowed --add-data "..." --icon=app.ico pdf_metadata_viewer.py