PySide6 代码式教程

用代码实例讲解 PySide6 ！

简介

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

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

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

访问在线思维导图目录

如何使用

一、获取源代码

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

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

方式 A ：venv（简单易用，推荐）

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

方式 B ：Poetry

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

更多 Poetry 使用方法信息，请参阅其官方文档。

方式 C ：其他包管理工具

1. 使用你喜欢的其他工具创建虚拟环境，如 Pipenv、Conda 等
2. 安装 requirements.txt 中描述的依赖项

三、运行与学习

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

项目结构

主要

其他

贡献

PySide6 Code Tutorial 是一个开源项目，非常期待以及感谢你的参与贡献。共同完善这个项目，让它帮助到更多人。

贡献的方式有很多种，并不一定都需要高超的编程能力：

• 指出错别字、错误拼写等
• 提议加入新功能、新模块等
• 参与某个 QWidget 控件相关代码编写
• 投稿优质 PySide6 相关博文、QSS 样式等
• ……

关于为本项目提交贡献的详细信息，请查阅贡献指南。

开源许可与分享约定

代码

本仓库中的代码使用 GPL-3.0 许可开源。对本项目的复制、分发和修改，请严格遵守该协议。

为便于使用者在自己的项目或博客文章中使用本仓库的代码片段，作以下分享约定：

文章

本仓库中的文章，凡未注明作者的，均为 muzing 所著，使用 CC-BY 4.0 协议发布。

打赏

如果本项目对你有帮助，可以请主要作者/维护者喝一杯冰可乐 :beer:。