Windows下使用PyInstaller打包PyQt项目
在 Windows 环境下,使用 PyQt 开发的项目可以通过多种工具打包成 可执行文件(.exe),以下是几种常见的方法及详细步骤:
1. 使用 PyInstaller
PyInstaller 是最常用的 Python 打包工具,支持 PyQt5/PyQt6/PySide6,适用于 Windows、macOS 和 Linux。
步骤
(1) 安装 PyInstaller
pip install pyinstaller
(2) 基本打包命令
pyinstaller -F -w --icon=app.ico main.py
-F
:打包成单个.exe
文件(可选,默认生成文件夹)。-w
:隐藏控制台(适用于 GUI 程序)。--icon=app.ico
:设置应用程序图标(可选)。main.py
:你的 PyQt 主程序入口文件。如果使用的是PyQt的WebEngine模块,可能需要添加
--windowed
参数(对于GUI应用)以及正确处理WebEngine的依赖项。pyinstaller --windowed --onefile your_script.py
(3) 处理资源文件(图片、数据库等)
如果你的项目使用了外部资源(如 .png
、.db
),需要在打包时指定路径:
pyinstaller --add-data "images;images" --add-data "data.db;." main.py
或者在 .spec
文件中配置:
a = Analysis(['main.py'],datas=[('images/*', 'images'), ('data.db', '.')], # (源路径, 打包后路径)... )
(4) 生成 .spec
文件(高级配置)
pyinstaller --onefile --windowed --icon=app.ico main.py
这会生成 main.spec
,可手动修改后再运行:
pyinstaller main.spec
(5) 最终输出
dist/
目录下生成.exe
文件。build/
目录包含临时文件(可删除)。