第六讲：图形界面应用打包实战

大家好，这里是程序员晚枫，正在all in AI编程实战，全网同名。

（Tkinter / PyQt5 / PySide6 一次讲透，带图标、高 DPI、暗黑模式）

开场 30 秒
“GUI 程序打包后双击无窗口、图标模糊、Qt 插件缺失？”
本讲 20 分钟，用 3 个完整案例演示“从源码到安装包”的全流程，并给出可复制粘贴的 .spec 模板。

6.0 前置清单（1 min）

工具	版本	作用
pyinstaller	≥ 6.8	核心打包
Tkinter	Python 内置	轻量 GUI
PyQt5 / PySide6	pip 最新	跨平台商业级 UI
Qt-Tool	`pip install pyqt5-tools`	生成 .qrc / designer

6.1 Tkinter 单文件打包（5 min）

示例源码

# tk_hello.py
import tkinter as tk
root = tk.Tk()
root.title("Hello Tk")
tk.Label(root, text="打包成功！").pack(padx=40, pady=20)
root.mainloop()

一键打包

1	pyinstaller --onefile --noconsole --icon=tk.ico tk_hello.py

高 DPI 不模糊

# 在 tk_hello.py 顶部加
try:
    from ctypes import windll
    windll.shcore.SetProcessDpiAwareness(1)
except:
    pass

6.2 PyQt5 完整工程打包（8 min）

工程结构

myqt/
├─ main.py
├─ ui/
│  ├─ main.ui
│  └─ resources.qrc
├─ icons/
│  └─ app.ico
└─ requirements.txt

资源编译

1 2	pyrcc5 ui/resources.qrc -o ui/resources_rc.py pyuic5 ui/main.ui -o ui/main_window.py

.spec 模板（可直接抄）

# -*- mode: python -*-
import pathlib
ROOT = pathlib.Path('.').resolve()

a = Analysis(
    ['main.py'],
    pathex=[ROOT],
    binaries=[],
    datas=[(ROOT/'icons', 'icons')],
    hiddenimports=['PyQt5.sip', 'PyQt5.QtPrintSupport'],
    excludes=['PyQt5.QtWebEngine'],
    hookspath=[],
)

pyz = PYZ(a.pure, a.zipped_data)

exe = EXE(
    pyz, a.scripts, a.binaries, a.zipfiles, a.datas,
    name='MyQtApp',
    icon=ROOT/'icons/app.ico',
    debug=False,
    console=False,          # GUI 无黑框
    upx=True,
    upx_exclude=['Qt5Core.dll', 'Qt5Gui.dll'],
)

# onedir 可加 COLLECT；单文件无需

打包 & 运行

1 2	pyinstaller MyQtApp.spec dist/MyQtApp/MyQtApp.exe # 或 .app / 无后缀

6.3 PySide6 暗黑模式与 macOS .app（4 min）

启用系统暗黑

1
2
3

# 在 main.py
from PySide6.QtCore import QCoreApplication, Qt
QCoreApplication.setAttribute(Qt.AA_EnableHighDpiScaling)

macOS 上自动跟随系统深浅色。

生成 .app 结构

1	pyinstaller --onedir --name MySideApp --noconsole --icon app.icns main.py

输出

1 2	dist/MySideApp.app/ └─ Contents/MacOS/MySideApp

可用 codesign 签名后再发用户。

6.4 通用避坑清单（2 min）

问题	症状	解决
Qt 插件缺失	启动报 `could not find or load the Qt platform plugin`	确保 `hiddenimports` 含 `PyQt5.QtCore` 且 `datas` 拷贝 `plugins/platforms`
图标模糊	高 DPI 屏锯齿	Tkinter 加 DPI Awareness，Qt 加 `Qt.AA_EnableHighDpiScaling`
窗口无焦点	macOS 首次启动 Dock 跳两下	`Info.plist` 加 `LSUIElement=NO`
字体异常	中文字符框	把字体 TTF 放 `datas`，代码里 `QFontDatabase.addApplicationFont` 加载