当前位置：首页>python>7天上手PyQt6 Python 桌面应用开发之PyQt6 介绍与安装

7天上手PyQt6 Python 桌面应用开发之PyQt6 介绍与安装

2026-03-27 01:08:42

概述

想快速开发高颜值 Python 桌面应用？本篇将带你入门 PyQt6，从核心简介、库与工具库配置（含 Qt Designer 可视化设计），到完整入门实例，一步步解锁高效桌面程序开发，小白也能轻松上手。

PyQt6 介绍与安装

（一）PyQt6 简介

PyQt 是一个创建 GUI 应用程序的工具包。它是 Python 编程语言和 Qt 库的成功融合。Qt 库是最强大的库之一。PyQt 是由 Phil Thompson 开发。

PyQt 实现了一个 Python 模块集。它有超过 300 类，将近 6000 个函数和方法。它是一个多平台的工具包，可以运行在所有主要操作系统上，包括 UNIX，Windows 和 Mac。PyQt 采用双许可证，开发人员可以选择 GPL 和商业许可。在此之前，GPL 的版本只能用在 Unix 上，从 PyQt 的版本 4 开始，GPL 许可证可用于所有支持的平台。最新版本是 6。

因为可用的类有很多，他们被分成几个模块。QtCore 模块包含核心的非 GUI 功能。该模块用于时间、文件和目录、各种数据类型、流、网址、MIME 类型、线程或进程。QtGui 模块包含图形组件和相关的类，例如按钮、窗体、状态栏、工具栏、滚动条、位图、颜色、字体等。QtNetwork 模块包含了网络编程的类，这些类允许编写 TCP/IP 和 UDP 的客户端和服务器，使网络编程更简单，更轻便。QtXml 包含使用 XML 文件的类，这个模块提供了 SAX 和 DOM API 的实现。QtSvg 模块提供显示的 SVG 文件的类。可缩放矢量图形（SVG）是一种用于描述二维图形和图形应用程序的 XML 语言。QtOpenGL 模块使用 OpenGL 库渲染 3D 和 2D 图形，该模块能够无缝集成 Qt 的 GUI 库和 OpenGL 库。QtSql 模块提供用于数据库的类。

（二）PyQt6 库和工具库 QTDesigner 安装与配置

安装 PyQt6 和 pyqt6-tools

注意，这里有一个版本对应的问题。我这里使用的Python版本为3.11，一开始我是用的Python3.14，下面的pyqt6-tools是不成功的。把Python的编译环境降版本就OK了。

PyQt6 库是 PyQt 的开发库

pip install PyQt6

-i https://pypi.tuna.tsinghua.edu.cn/simple

pyqt6-tools 库是 QTDesigner 设计器工具支持库

pip install pyqt6-tools

-i https://pypi.tuna.tsinghua.edu.cn/simple

在 pycharm 中配置外部工具 QTDesigner 和 PYUIC

配置外部工具 QTDesigner

QTDesigner 是 QT 界面设计器

打开 Pycharm -> Settings -> Tools -> External Tools

Name 写 QTDesigner

Tool Settings -> Program: 写你 Python3 的安装目录下 designer.exe 路径

我这边本地是：

D:\software\it\python11\Lib\site-packages\qt6_applications\Qt\bin\designer.exe

Name 写 PYUIC

program 填 Python 路径

arguments：

-m PyQt6.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py

working directory 填：$FileDir$

验证安装是否成功

Tools -> QTDesigner 打开设计器

能显示这个说明QTDesigner 安装成功。选Widget，创建，在拖一个按钮进去。

保存ui文件。放入Python项目里面。然后先选中ui文件，再选Tools -> PyUIC

看到生成ui文件对应的python文件，就说明PyUIC配置成功。

（三）PyQt6 程序入门实例

PyQt6 核心模块导入：掌握从PyQt6.QtWidgets导入常用界面组件（QApplication、QWidget、QLabel），以及sys模块的引入（用于处理系统参数和程序退出）。
QApplication 应用对象创建：理解QApplication(sys.argv)是 PyQt6 程序的入口，负责管理应用程序的生命周期，sys.argv用于传递命令行参数。
QWidget 基础窗口操作：

创建 QWidget 实例作为基础窗口容器；
调用setWindowTitle设置窗口标题；
调用resize调整窗口尺寸（宽、高）；
调用move设置窗口在屏幕中的显示位置；
调用show显示窗口组件（PyQt6 组件默认隐藏，需手动调用 show 展示）。

4.QLabel 标签组件使用：

创建 QLabel 实例显示文本内容；
调用setText设置标签显示的文本；
调用move/resize调整标签的位置和尺寸；
调用setStyleSheet通过 CSS 样式表设置组件样式（如背景色、内边距）。

5.组件父子关系设置：通过setParent将 QLabel 绑定到 QWidget 窗口，使标签成为窗口的子组件，随窗口显示 / 隐藏。

6.PyQt6 程序运行与退出机制：

调用app.exec()启动应用的消息循环，使程序进入事件等待状态；
结合sys.exit()执行程序退出，确保程序结束时正确释放资源，正常退出消息循环。

PyQt6 运行 QTDesigner 生成的 ui 文件程序

PyQt6 模块导入：掌握导入 QApplication（应用程序核心类）、uic 模块（用于加载.ui 文件）以及 sys 模块（处理程序退出）的方法。
QApplication 应用对象创建：通过QApplication(sys.argv)初始化 PyQt6 应用程序，为 GUI 运行提供基础环境。
直接加载.ui 文件：使用uic.loadUi()方法加载本地的.ui 文件（无需提前转换为.py 文件），简化界面调用流程，支持直接读取 QTDesigner 生成的界面文件。
界面显示：调用加载后的 ui 对象的show()方法，展示 QTDesigner 设计的界面。
程序运行与退出机制：通过app.exec()启动应用的消息循环，结合sys.exit()确保程序退出时正确释放资源，完成 GUI 程序的生命周期管理。

ui文件.ui