PyCharm 打包 Python 為 exe：pyinstaller + GUI 庫（PyQt/wxPython）完整流程

步驟

1. 安裝打包工具：

   pip install pyinstaller

2. 編寫 GUI 程序（以 PyQt5 為例）：

   
     import sys
     from PyQt5.QtWidgets import QApplication, QLabel
     app = QApplication(sys.argv)
     label = QLabel("Hello PyInstaller!")
     label.show()
     sys.exit(app.exec_())
     

3. 打包命令：

   
     pyinstaller --onefile --windowed --icon=app.ico main.py
     # --onefile: 產生單一 exe
     # --windowed: 隱藏控制台 (GUI 程序必須)
     # --icon: 設置圖標
     

4. 輸出：dist/main.exe 可直接雙擊運行。

常見問題

• 缺少模塊：--hidden-import=module_name 或編寫 .spec 文件精確控制。
• 資源文件：--add-data "images;images" (Windows 分號分隔)。
• 殺毒軟件誤報：簽名 exe 或加入白名單。
• 體積大：UPX 壓縮 --upx-dir=... 或排除不需模塊。

替代工具

• cx_Freeze：跨平台，配置靈活。
• Nuitka：編譯為 C 再編譯，性能更好，啟動更快。