在?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/
?目錄包含臨時文件(可刪除)。