使用 PyInstaller 打包 Python 脚本为 EXE（教程）

PyInstaller 是一个流行的工具，可以将 Python 脚本打包成独立的可执行文件（EXE），无需用户安装 Python 环境。以下是详细步骤。

安装 PyInstaller：

bash 复制代码

pip install pyinstaller

确保 Python 脚本所在的目录是当前工作目录，运行以下命令生成 EXE：

bash 复制代码

pyinstaller --onefile --windowed your_script.py

--onefile 选项将所有依赖打包成一个 EXE 文件，--windowed 选项隐藏命令行窗口（适用于 GUI 应用）。

生成的 EXE 文件位于 dist 目录下。可以直接运行或分发给其他用户。

auto-py-to-exe 是一个基于 PyInstaller 的 GUI 工具，适合不熟悉命令行的用户。

安装 auto-py-to-exe：

bash 复制代码

pip install auto-py-to-exe

启动 GUI 界面：

bash 复制代码

auto-py-to-exe

在界面中选择 Python 脚本文件，配置输出选项（如单文件模式、隐藏控制台等），点击"Convert .py to .exe"开始打包。生成的 EXE 文件默认保存在输出目录中。

某些情况下，打包后的 EXE 可能因缺失依赖而无法运行。可以通过以下方法解决：

检查 PyInstaller 生成的日志文件（通常在 build 目录中），确认是否有缺失的模块或文件。

手动添加数据文件（如图片、配置文件）：

bash 复制代码

pyinstaller --onefile --add-data "data_file;." your_script.py

对于隐藏导入的模块（如动态导入的库），使用 --hidden-import 参数：

bash 复制代码

pyinstaller --onefile --hidden-import module_name your_script.py

PyInstaller 打包的 EXE 文件可能较大，可以通过以下方法优化：

使用 UPX 压缩工具。下载 UPX 并解压，在 PyInstaller 命令中指定 UPX 路径：

bash 复制代码

pyinstaller --onefile --upx-dir=path_to_upx your_script.py

排除不必要的库。例如，如果脚本未使用 numpy，可以通过 --exclude-module 排除：

bash 复制代码

pyinstaller --onefile --exclude-module numpy your_script.py

如果 EXE 文件运行时报错，可以通过命令行运行以查看详细错误信息：

bash 复制代码

dist/your_script.exe

对于更复杂的调试，可以在打包时禁用控制台隐藏：

bash 复制代码

pyinstaller --onefile --noconsole your_script.py

检查 PyInstaller 生成的 .spec 文件，确认打包配置是否正确。必要时手动编辑 .spec 文件并重新打包：

bash 复制代码

pyinstaller your_script.spec

如果有其他问题欢迎留言～

点个关注

进入我主页「资源」

免费下载，直接运行

持续分享Python/网页/小程序/电脑实用工具，

不套路、不加密，关注不迷路！