Top AI Repos — open-source AI, indexed and scored

Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.

muziing/PySide6-Code-Tutorial

可能是最好的PySide6中文教程！用代码实例讲解PySide6，附优质Demos、图标库、QSS皮肤、相关文章等分享！

61GPL-3.0Python

View on GitHub

Stars: 1,878
Forks: 206
Watchers: 13
Open issues: 2
Contributors: 4

Star history, last 90 days+31 over 25 snapshots

2026-07-24 · 1,8472026-09-20 · 1,878

Star history, last 90 days
Date	Stars
2026-07-24	1847
2026-07-25	1847
2026-07-28	1847
2026-07-30	1847
2026-08-09	1858
2026-08-17	1862
2026-08-19	1863
2026-08-20	1864
2026-08-21	1864
2026-08-22	1865
2026-08-23	1866
2026-08-24	1867
2026-08-26	1868
2026-08-27	1867
2026-08-29	1868
2026-08-30	1869
2026-09-01	1870
2026-09-03	1870
2026-09-05	1871
2026-09-09	1872
2026-09-11	1873
2026-09-12	1874
2026-09-16	1876
2026-09-17	1878
2026-09-20	1878

Today

— stars today

This week

+4 stars this week

This month

+14 stars this month

Momentum

4.0

growth rate 0.21%/day

From the README

<img src="./Resources/Icons/Qt_for_Python_128px.png" alt="logo" height="128" align="right" />

# PySide6 代码式教程

用代码实例讲解 PySide6 ！

![GitHub Repo stars](https://img.shields.io/github/stars/muziing/PySide6-Code-Tutorial)
![License](https://img.shields.io/github/license/muziing/PySide6-Code-Tutorial)
![GitHub Last Commit](https://img.shields.io/github/last-commit/muziing/PySide6-Code-Tutorial)
[![PySide Version](https://img.shields.io/badge/PySide-6.6-blue)](https://doc.qt.io/qtforpython/index.html)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)

## 简介

本教程旨在通过可以直接在本地机器上运行的脚本代码讲解介绍 **PySide6**。

- 代码中以详细的注释作为讲解
- 每个模块（`.py`文件）都可独立运行，演示了各种控件的各种功能、属性、作用
- 在自己的机器上实际运行一下，仔细观察一下每个属性值的改变会怎样影响控件的外观行为，可能比静态的文档教程更有效
- 前身为 GitHub 热度最高的中文 PyQt5 教程 [PyQt-Practice](https://github.com/muziing/PyQt_practice)，目前已有 ![PyQt-Practice Stars](https://img.shields.io/github/stars/muziing/PyQt_practice.svg) 个 Stars
- 相比 [PyQt-Practice](https://github.com/muziing/PyQt_practice)，改进了项目目录结构，增加了部分内容，更加清晰丰富
- 使用最新的 Python 与 PySide 版本（目前为`3.11`与`6.6`）

希望本项目对你我的 Python-GUI 学习之旅有所帮助。

![思维导图目录](./Resources/Images/TOC-MindMap.png)

[访问在线思维导图目录](https://www.processon.com/view/link/63034ce01efad47d1247911e)

## 如何使用

### 一、获取源代码

1. Star 本仓库
2. 通过以下方法之一获取源码
   - 克隆仓库（推荐）：`git clone https://github.com/muziing/PySide6-Code-Tutorial.git`
   - 下载 zip：<https://github.com/muziing/PySide6-Code-Tutorial/archive/refs/heads/main.zip>
   - 查看 [Releases](https://github.com/muziing/PySide6-Code-Tutorial/releases) 界面，下载最新发布版（文件更小）
3. 进入项目目录

### 二、配置虚拟环境与安装依赖

**方式 A** ：[venv](https://docs.python.org/zh-cn/3/library/venv.html)（简单易用，推荐）

1. 确保 Python 版本与 [pyproject.toml](./pyproject.toml) 中要求的一致
2. 创建虚拟环境
   - Windows: `python -m venv --upgrade-deps venv`
   - Linux/macOS: `python3 -m venv --upgrade-deps venv`
3. 激活虚拟环境
   - Windows: `venv\Scripts\activate`
   - Linux/macOS: `. venv/bin/activate`
4. 安装依赖：`pip install -r requirements.txt`

**方式 B** ：[Poetry](https://python-poetry.org/)

1. 确保 Python 版本与 [pyproject.toml](./pyproject.toml) 中要求的一致
2. 按[官方文档](https://python-poetry.org/docs/#installation)提示安装 Poetry
3. 创建虚拟环境：`poetry env use /full/path/to/python`（注意替换路径）
4. 安装依赖：`poetry install --no-root --only main`
5. 使用该虚拟环境： `poetry shell`（或在 PyCharm 等 IDE 中配置）

> 更多 Poetry 使用方法信息，请参阅其[官方文档](https://python-poetry.org/docs/)。

**方式 C** ：其他包管理工具

1. 使用你喜欢的其他工具创建虚拟环境，如 [Pipenv](https://pipenv.pypa.io/)、[Conda](https://www.anaconda.com/) 等
2. 安装 [requirements.txt](./requirements.txt) 中描述的依赖项

### 三、运行与学习

1. 打开感兴趣的 `.py` 模块
2. 阅读文档部分
3. 运行，观察该界面/控件效果
4. 阅读代码中的注释，可根据提示对特定行进行「注释/取消注释」
5. 再次运行该模块，观察变化

## 项目结构

### 主要

| 目录/文件                                                           | 描述                                  |
|-----------------------------------------------------------------|-------------------------------------|
| [00. PySide Learning - 各种学习资源](./00-PySideLearning-文章教程Demo等资源) | 文章、教程、Demo等资源                       |
| [01. HelloWorld - PySide 基本结构](./01-HelloWorld-基本结构)            | 新手上路，PySide6 程序的基本结构                |
| [02. QtCore - 非GUI的核心功能](./02-QtCore-非GUI的核心功能)                 | 元对象系统、「信号与槽」通信机制等                   |
| [03. QtWidgets - 常用控件](./03-QtWidgets-常用控件)                     | 按钮、输入框、文本编辑器、下拉菜单、滚动条等等常用控件的功能、用法   |
| [04. QtGui - 使用GUI功能扩展QtCore](./04-QtGui-使用GUI功能扩展QtCore)       | 位图、字体、颜色、键盘快捷键等、事件（暂未完成）            |
| [05. QtWidgets - 进阶话题](./05-QtWidgets-进阶话题)                     | 布局管理器、QSS样式、主窗口控件等                  |
| [06. Model/View - 模型与视图、数据库](./06-ModelView-模型与视图、数据库)          | 模型与视图、与数据库交互                        |
| [07. Packaging - 静态资源编译、打包](./07-Packaging-资源管理与打包)             | 将应用程序打包为 `exe`、将静态资源编译至二进制 `qrc` 文件 |
| ……

Excerpt of 6,049 characters

Read on GitHub

Top contributors4 shown

Quality score

Would you bet a product on this? Bounded 0–100 and slow moving.

61/10061

Maintenance: 90%; How recently the default branch was pushed to
Releases: 25%; Recency and cadence of tagged releases
Community: 15%; Contributor breadth and bus factor
Issue backlog: 100%; Open issues measured against the size of the audience
Documentation: 77%; README depth, plus a homepage and topics
Licensing: 55%; How freely the code can be adopted

What to know before adopting

No tagged releases
Bus factor of 1 — one contributor dominates
Copyleft license — derivative works must be open-sourced
Derivative works must be released under the same licence.

Details

Created: 4 years ago
Last push: 20 days ago
Last release: none
Release tag: —
Releases in the last year: 0
Default branch: main
Size: 5.6k KB
Owner type: User
Owner location: Beijing, China
Discovered via: topic:tutorial
First indexed: 2 months ago
Last synced: yesterday

muziing/PySide6-Code-Tutorial

可能是最好的PySide6中文教程！用代码实例讲解PySide6，附优质Demos、图标库、QSS皮肤、相关文章等分享！

61GPL-3.0Python

View on GitHub

Stars: 1,878
Forks: 206
Watchers: 13
Open issues: 2
Contributors: 4

Star history, last 90 days+31 over 25 snapshots

2026-07-24 · 1,8472026-09-20 · 1,878

Star history, last 90 days
Date	Stars
2026-07-24	1847
2026-07-25	1847
2026-07-28	1847
2026-07-30	1847
2026-08-09	1858
2026-08-17	1862
2026-08-19	1863
2026-08-20	1864
2026-08-21	1864
2026-08-22	1865
2026-08-23	1866
2026-08-24	1867
2026-08-26	1868
2026-08-27	1867
2026-08-29	1868
2026-08-30	1869
2026-09-01	1870
2026-09-03	1870
2026-09-05	1871
2026-09-09	1872
2026-09-11	1873
2026-09-12	1874
2026-09-16	1876
2026-09-17	1878
2026-09-20	1878

Today

— stars today

This week

+4 stars this week

This month

+14 stars this month

Momentum

4.0

growth rate 0.21%/day

From the README

<img src="./Resources/Icons/Qt_for_Python_128px.png" alt="logo" height="128" align="right" />

# PySide6 代码式教程

用代码实例讲解 PySide6 ！

![GitHub Repo stars](https://img.shields.io/github/stars/muziing/PySide6-Code-Tutorial)
![License](https://img.shields.io/github/license/muziing/PySide6-Code-Tutorial)
![GitHub Last Commit](https://img.shields.io/github/last-commit/muziing/PySide6-Code-Tutorial)
[![PySide Version](https://img.shields.io/badge/PySide-6.6-blue)](https://doc.qt.io/qtforpython/index.html)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)

## 简介

本教程旨在通过可以直接在本地机器上运行的脚本代码讲解介绍 **PySide6**。

- 代码中以详细的注释作为讲解
- 每个模块（`.py`文件）都可独立运行，演示了各种控件的各种功能、属性、作用
- 在自己的机器上实际运行一下，仔细观察一下每个属性值的改变会怎样影响控件的外观行为，可能比静态的文档教程更有效
- 前身为 GitHub 热度最高的中文 PyQt5 教程 [PyQt-Practice](https://github.com/muziing/PyQt_practice)，目前已有 ![PyQt-Practice Stars](https://img.shields.io/github/stars/muziing/PyQt_practice.svg) 个 Stars
- 相比 [PyQt-Practice](https://github.com/muziing/PyQt_practice)，改进了项目目录结构，增加了部分内容，更加清晰丰富
- 使用最新的 Python 与 PySide 版本（目前为`3.11`与`6.6`）

希望本项目对你我的 Python-GUI 学习之旅有所帮助。

![思维导图目录](./Resources/Images/TOC-MindMap.png)

[访问在线思维导图目录](https://www.processon.com/view/link/63034ce01efad47d1247911e)

## 如何使用

### 一、获取源代码

1. Star 本仓库
2. 通过以下方法之一获取源码
   - 克隆仓库（推荐）：`git clone https://github.com/muziing/PySide6-Code-Tutorial.git`
   - 下载 zip：<https://github.com/muziing/PySide6-Code-Tutorial/archive/refs/heads/main.zip>
   - 查看 [Releases](https://github.com/muziing/PySide6-Code-Tutorial/releases) 界面，下载最新发布版（文件更小）
3. 进入项目目录

### 二、配置虚拟环境与安装依赖

**方式 A** ：[venv](https://docs.python.org/zh-cn/3/library/venv.html)（简单易用，推荐）

1. 确保 Python 版本与 [pyproject.toml](./pyproject.toml) 中要求的一致
2. 创建虚拟环境
   - Windows: `python -m venv --upgrade-deps venv`
   - Linux/macOS: `python3 -m venv --upgrade-deps venv`
3. 激活虚拟环境
   - Windows: `venv\Scripts\activate`
   - Linux/macOS: `. venv/bin/activate`
4. 安装依赖：`pip install -r requirements.txt`

**方式 B** ：[Poetry](https://python-poetry.org/)

1. 确保 Python 版本与 [pyproject.toml](./pyproject.toml) 中要求的一致
2. 按[官方文档](https://python-poetry.org/docs/#installation)提示安装 Poetry
3. 创建虚拟环境：`poetry env use /full/path/to/python`（注意替换路径）
4. 安装依赖：`poetry install --no-root --only main`
5. 使用该虚拟环境： `poetry shell`（或在 PyCharm 等 IDE 中配置）

> 更多 Poetry 使用方法信息，请参阅其[官方文档](https://python-poetry.org/docs/)。

**方式 C** ：其他包管理工具

1. 使用你喜欢的其他工具创建虚拟环境，如 [Pipenv](https://pipenv.pypa.io/)、[Conda](https://www.anaconda.com/) 等
2. 安装 [requirements.txt](./requirements.txt) 中描述的依赖项

### 三、运行与学习

1. 打开感兴趣的 `.py` 模块
2. 阅读文档部分
3. 运行，观察该界面/控件效果
4. 阅读代码中的注释，可根据提示对特定行进行「注释/取消注释」
5. 再次运行该模块，观察变化

## 项目结构

### 主要

| 目录/文件                                                           | 描述                                  |
|-----------------------------------------------------------------|-------------------------------------|
| [00. PySide Learning - 各种学习资源](./00-PySideLearning-文章教程Demo等资源) | 文章、教程、Demo等资源                       |
| [01. HelloWorld - PySide 基本结构](./01-HelloWorld-基本结构)            | 新手上路，PySide6 程序的基本结构                |
| [02. QtCore - 非GUI的核心功能](./02-QtCore-非GUI的核心功能)                 | 元对象系统、「信号与槽」通信机制等                   |
| [03. QtWidgets - 常用控件](./03-QtWidgets-常用控件)                     | 按钮、输入框、文本编辑器、下拉菜单、滚动条等等常用控件的功能、用法   |
| [04. QtGui - 使用GUI功能扩展QtCore](./04-QtGui-使用GUI功能扩展QtCore)       | 位图、字体、颜色、键盘快捷键等、事件（暂未完成）            |
| [05. QtWidgets - 进阶话题](./05-QtWidgets-进阶话题)                     | 布局管理器、QSS样式、主窗口控件等                  |
| [06. Model/View - 模型与视图、数据库](./06-ModelView-模型与视图、数据库)          | 模型与视图、与数据库交互                        |
| [07. Packaging - 静态资源编译、打包](./07-Packaging-资源管理与打包)             | 将应用程序打包为 `exe`、将静态资源编译至二进制 `qrc` 文件 |
| ……

Excerpt of 6,049 characters

Read on GitHub

Top contributors4 shown

Quality score

Would you bet a product on this? Bounded 0–100 and slow moving.

61/10061

Maintenance: 90%; How recently the default branch was pushed to
Releases: 25%; Recency and cadence of tagged releases
Community: 15%; Contributor breadth and bus factor
Issue backlog: 100%; Open issues measured against the size of the audience
Documentation: 77%; README depth, plus a homepage and topics
Licensing: 55%; How freely the code can be adopted

What to know before adopting

No tagged releases
Bus factor of 1 — one contributor dominates
Copyleft license — derivative works must be open-sourced
Derivative works must be released under the same licence.

Details

Created: 4 years ago
Last push: 20 days ago
Last release: none
Release tag: —
Releases in the last year: 0
Default branch: main
Size: 5.6k KB
Owner type: User
Owner location: Beijing, China
Discovered via: topic:tutorial
First indexed: 2 months ago
Last synced: yesterday

Top AI Repos — open-source AI, indexed and scored

muziing/PySide6-Code-Tutorial

From the README

Top contributors4 shown

Quality score

What to know before adopting

Categories

Details

muziing/PySide6-Code-Tutorial

From the README

Top contributors4 shown

Quality score

What to know before adopting

Categories

Details

Top AI Repos — open-source AI, indexed and scored

Trend

From the README

Top contributors4 shown

Quality score

What to know before adopting

Categories

Details

Trend

From the README

Top contributors4 shown

Quality score

What to know before adopting

Categories

Details