当前位置：首页 > news >正文

PySide6从0开始学习的笔记（一）学前班

news 2026/3/27 3:12:12

PySide6 是 Qt 框架的 Python 绑定库，用于开发跨平台（Windows/macOS/Linux/ 移动端等）图形界面（GUI）应用，核心优势是功能强大、性能稳定、跨平台兼容性强，且完全开源免费，适合从入门到企业级 GUI 开发。

不知不觉，使用PySide6做开发也有几年了，但是都是被工作所逼，用一点学一点，知识面零散而杂乱，也走了不少弯路。是时候系统学习和总结一次了。由于本人是业余程序员，错漏之处还望指教。

一、学习前置基础

Python 基础：掌握变量、函数、类与面向对象（OOP）、模块导入等核心语法（PySide6 重度依赖类继承、实例化等 OOP 思想）；
Qt 核心概念认知：无需学 C++ Qt，只需初步了解 “控件（Widget）、布局（Layout）、信号与槽（Signal & Slot）” 三大核心 —— 这是 PySide6 开发的灵魂。
有关pyside6的其他介绍，见：https://blog.csdn.net/xulibo5828/article/details/145307815

面向对象（OOP）的名词解释：

二、环境搭建和基本框架

安装pyside6，只需下面一条指令，简单直接，自动适配 Python 版本：

pip install pyside6

最简框架示例：

import sys from PySide6.QtWidgets import QApplication, QWidget app = QApplication(sys.argv) window = QWidget() window.show() sys.exit(app.exec())

在pycharm中创建Python脚本并运行上面代码，会出现一个应用窗口：

这样就完成了一个最简的pyside6应用程序创建和运行。

三、基本代码的详解

1、app = QApplication(sys.argv)

app = QApplication(sys.argv)

QApplication：这部分创建了一个Qt应用程序对象。QApplication是Qt框架中用于管理应用程序的类。
sys.argv：是 Python 程序的标准命令行参数入口，Qt 官方文档（QApplication 文档）明确建议传入这个参数。app = QApplication(sys.argv)是作为一个规范用法存在的。

你可以做一个测试，在Windows下，将上述代码的sys.argv省去，写成app = QApplication()也是可以运行的；但是在有些版本的Linux下会运行出错。所以建议按照官方推荐使用。

sys.argv的规则如下：

sys.argv是一个列表，它的所有元素都是字符串。

列表第 0 个元素（sys.argv[0]）：当前脚本本身的路径 / 文件名（是参数列表的固定第一个元素），这个参数任何时候都不要修改；

列表第 1 个及以后元素（sys.argv[1:]）：运行脚本时手动传入的额外命令行参数。

验证一下：

import sys print(sys.argv)

以上代码打印的结果：

['E:\\pyside6_new_baseDemo\\tmp\\tmp.py']

进一步的，简单体验一下自定义设置sys.argv参数：

import sys from PySide6.QtWidgets import QApplication, QWidget # 自定义sys.argv：模拟传入Qt的-style参数 sys.argv = [sys.argv[0], "-style", "fusion"] # 第0个元素保留脚本名，后续加自定义参数 window_style = sys.argv[2] app = QApplication(sys.argv) # Qt会解析修改后的sys.argv，应用fusion样式 window = QWidget() window.setWindowTitle(f"{window_style}样式窗口") window.show() sys.exit(app.exec())

上面的-style是Qt 支持的命令行参数，它指定了窗口的显示风格，避免跨平台运行时显示风格的不一致。除了Qt 支持的命令行参数以外，sys.argv中也可以是自己定义的业务参数。比如：

import sys from PySide6.QtWidgets import QApplication, QWidget # 自定义sys.argv： sys.argv = [sys.argv[0], "-style", "windows", "mySize", "300"] # 第0个元素保留脚本名，后续加自定义参数 window_style = sys.argv[2] # 第2个元素是-style参数的值(QT自带) window_size = int(sys.argv[4]) # 第4个元素是size参数的值（自定义的） app = QApplication(sys.argv) # Qt会解析修改后的sys.argv，应用fusion样式 window = QWidget() # 创建窗口 window.setWindowTitle(f"{window_style}样式窗口") # 设置窗口标题 window.resize(window_size, window_size) # 设置窗口大小 window.show() # 显示窗口 sys.exit(app.exec()) # 运行应用程序

运行的结果，显示了一个Windows风格的，尺寸是300*300的窗口。

2、window = QWidget()

这行代码是PyQt/PySide中的基础用法，核心作用是创建一个窗口对象，简要解析如下：

关键组成

QWidget：Qt 中所有可视化组件的基类（按钮、标签、窗口等都继承自它），本身可作为独立窗口（顶层容器）使用；

window：自定义的变量名，用于引用创建的窗口对象（后续可通过该变量操作窗口，如设置大小、标题、显示等）；

QWidget()：调用QWidget的构造函数，创建实例 —— 此处未传入父对象（parent=None是默认值），因此它是一个顶层窗口（有标题栏、边框，可独立显示 / 拖动）。

核心作用

创建一个 “空白的基础窗口容器”，后续需通过代码补充功能，例如：

window.setWindowTitle("我的窗口") # 设置标题 window.resize(400, 300) # 设置大小（宽400，高300） window.show() # 显示窗口

补充说明

若传入父对象（如QWidget(parent=some_widget)），则它不再是顶层窗口，而是父组件内的 “子部件”（如窗口内的面板）；

单独这一行代码不会显示窗口，必须调用show()方法才会渲染到屏幕；

3、window.show()

调用窗口的show()方法，将窗口从 “隐藏状态” 切换为 “显示状态”，绘制到屏幕上。另外，在实践中发现，show()的作用不仅仅是显示，它可能还隐含有一些，比如显示参数设置等操作。见：

https://mp.csdn.net/mp_blog/creation/editor/137729182

所以，我现在的习惯是，创建了窗口实例之后就先将其show()一次，将其所有的特性全部加载设置到位，如果不需要它继续显示就紧跟着将其hide()，隐藏它。

`4、`sys.exit(app.exec())

这条指令分为两部分：app.exec()和sys.exit()，当程序执行外层的sys.exit()时，会首先遇到作为参数传递的app.exec()：

app.exec()：app是之前创建的Qt应用程序对象，app.exec()的运行结果是启动 Qt 的事件循环（程序进入 “等待用户操作” 以及“刷新显示结果”的状态，如点击、拖拽、关闭窗口、刷新显示等事件都会被循环处理）。
sys.exit()：当事件循环结束（比如用户关闭了所有窗口，或者app.exec()的运行出现了错误），app.exec()就会执行完毕并返回一个状态码，sys.exit()接收该状态码并正常终止程序，确保资源释放。

整体逻辑：创建应用 → 传递参数→创建窗口 → 显示窗口 → 启动事件循环等待交互 → 关闭后终止程序并释放资源，这就是 Qt GUI 程序的标准模板。

查看全文

http://www.jsqmd.com/news/84252/