PySide6 Code Tutorial

用代码实例讲解 PySide6 ！

简介

之前的 PyQt-Practice 项目得到不少好评，目前已有 个 Stars。本项目沿用其形式，讲解介绍 PySide6。

• 代码中有较详细的注释作为讲解
• 几乎每个模块（.py文件）都可独立运行，展示了各种控件的各种功能属性作用
• 在自己的机器上实际运行一下，仔细观察一下每个属性值的改变会怎样影响控件的外观行为，可能比静态的文档教程更有效
• 相比 PyQt-Practice，改进了项目目录结构，更加清晰丰富

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

如何使用

获取源代码

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

配置虚拟环境与安装依赖

方式 A ：Poetry（推荐）

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

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

方式 B ：其他包管理工具

1. 使用你喜欢的其他工具创建虚拟环境
2. pip install -r requirements.txt

运行与学习

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

项目结构

TODO 定义项目结构

贡献

PySide6 Code Tutorial 是一个开源项目，非常期待你的参与贡献，共同完善它。

推荐阅读：如何为开源做贡献

TODO 创建关于贡献的独立文件

报告错误

如果在本项目中发现错误（不仅限于代码错误，也可以是文档、注释中的错别字等），请提交一个 Issue 以报告该错误。

Issue 中请简洁而清晰地描述该错误的位置、问题、（可选）改进建议。

修复错误

如果你认为自己有能力修复某个已有的 Issue 或刚刚发现的新问题，请按如下流程进行：

1. （对于新发现的错误）提交一个 Issue，描述其位置、问题
2. Fork 本仓库
3. 基于 dev 分支的最新提交，新建一个分支，名称为 Fix #123 （其中 123 为 Issue 编号）
4. 在新分支中修复错误，提交一个 Pull Request
5. 经代码审核，确认无误后，该分支会被合并入 dev 分支，未来将并入 main 分支

贡献代码

TODO 贡献代码细则

注意事项：

1. 确保已在本地开发环境安装全部「开发依赖项」，详见 pyproject.toml 中的 [tool.poetry.dev-dependencies]
2. 尽可能保证代码风格与现有代码一致

开源许可与分享约定

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

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

类型	代码行数	来自模块	使用要求
少量代码	< 100	单个 .py 模块	直接复制使用即可，无需声明
短片段	< 500	6 个以内 .py 模块	在代码首行添加 # 来自 github.com/muziing/PySide6-Code-Tutorial 注释；如对代码有修改则必须明确声明
基于本项目修改衍生的项目	> 500	多个 .py 模块	严格遵守 GPLv3 相关要求

打赏与捐助

本项目的主要作者/维护者是一名还没有收入的在校学生，如果本项目对你有帮助，希望可以请他喝一杯冰可乐 🍺。