PyQt examples：15个示例带你入门桌面应用开发

PyQt examples 是一个桌面应用开发示例合集，目前获得 2,571 Star。

这个仓库由 Michael Herrmann 维护，包含 15 个独立的 PyQt 示例程序，覆盖了桌面应用开发的常见场景。每个示例都可以单独运行，代码结构清晰，适合作为学习材料。

涵盖内容

15个示例按主题分布：

• 基础控件：QLabel、常用 Widgets、QVBoxLayout
• 交互机制：Signals and Slots、Qt Designer 集成
• 界面组件：QTreeView、QListView、自定义表格模型
• 功能实现：QPainter 绘图、多线程、数据库操作
• 进阶主题：QML 集成、文本编辑器、打包部署、深色主题

这些示例从最简单的 Hello World 开始，逐步过渡到复杂功能。比如 QLabel 示例只展示一个标签控件，而 QPainter 示例则是一个完整的射击游戏。

官方 Demo

仓库还收录了 PyQt 官方提供的演示程序。启动方式如下：

cd src/pyqt-official/qtdemo
python qtdemo.py

启动后会打开一个示例浏览器，可以直接运行各个官方 Demo。其中 Animation、Graphics Effects、System Tray、Screenshot、Tetrix 等示例比较经典。

运行方式

运行这些示例需要 Python 3。步骤如下：

1. 下载仓库 ZIP 包并解压
2. 进入根目录，创建虚拟环境：

python3 -m venv venv

3. 激活虚拟环境（Windows 用 call venv\Scripts\activate.bat，Mac/Linux 用 source venv/bin/activate）
4. 安装依赖：

pip install -Ur src/requirements.txt

5. 进入具体示例目录，运行 main.py：

cd "src/01 PyQt QLabel"
python main.py

绑定选择

仓库默认使用 PyQt6。如果需要用 PySide6，只需将所有 PyQt6 替换为 PySide6，包括 requirements.txt 和代码中的 import 语句。

如果想同时兼容两种绑定，可以使用 Qt.py。这个库会在运行时自动加载可用的绑定，使用时将 PyQt6 替换为 Qt 即可。

许可

src/ 目录下的 1 到 15 号示例采用 MIT 或 GPLv3 双许可。官方 Demo 采用 GPL 许可。截图的使用需要注明来源并链接到作者的 PyQt6 书籍。

示例采用 MIT 或 GPLv3 双许可。官方 Demo 采用 GPL 许可。截图的使用需要注明来源并链接到作者的 PyQt6 书籍。