PyQt5-新手避坑指南（持续更新）

---

一．前言

本篇博客整理了一些初学者容易犯的错，将会持续更新解决PyQt5开发过程中的一些坑，对新手比较友好，大佬请绕道 /笑哭

二．开发环境

笔者是在Windows11上使用Pycharm配合Python3.8进行开发的，详细开发环境信息如下：

1. 处理器：AMD Ryzen 7 7735H with Radeon Graphics 3.20 GHz
2. 系统版本：Windows 11 家庭中文版
3. 开发工具：PyCharm 2021.3
4. Python版本：Python3.8
5. PyQt5版本：PyQt5==5.15.10

三．坑

1.程序没有详细报错就退出了

代码执行时，直接报错Process finished with exit code - 1073740791 (Oxc0000409)然后就退出了。

按照下图指引打开“Emulate terminal in output console”

勾选后点击确定或应用

最新版本

然后再执行代码，就能够看到详细报错信息了

2.qrc资源文件的使用

我们在设计师或者代码里使用的资源文件都统一地使用qrc管理，qrc是什么呢？

.qrc是一个XML文件，它允许开发者将应用程序所需的图像、样式表、声音文件等各种资源集中管理。
通过将资源文件.qrc加载到PyQt5应用程序中，开发者可以轻松地访问和使用这些资源。
.qrc文件使用XML格式编写，包含一个或多个元素。
每个元素内可以包含多个元素，每个元素指定一个资源的路径和名称。

我们这里有个例子，比如当前项目根目录有个名为logo.png的图片文件，我们想让QLabel显示这张图片，那么我们可以这么操作：

1. 生成.qrc资源文件
2. 将qrc通过rcc工具转为.py文件
3. 在代码里使用资源

resources.qrc

demo.py
虽然第一步引入代码是灰色，但是不影响使用

有的同学可能会问，我直接写成**self.setPixmap(QPixmap(“logo.png”))**不也能使用资源么？我们这么写的目的是为了打包方便，当资源用多了就能体现得到。

3.QLabel文字自动换行

这个很好解决，一行代码

label.setWordWrap(True)

4.图片自适应大小

让我们的QLabel随着父控件的大小变化
这个很好解决，一行代码

label.setScaledContents(True)

5.checkbox自定义样式后✓不见了

当我们自定义了QCheckBox之后，发现左侧勾选区域的对号不见了，这通常是我们重写了QCheckBox::indicator::unchecked这很影响我们的ui，其实一张图片即可解决，在此我给出定义样式的qss：

#QCheckBox{
	color:rgb(44,206,162);
	font-size:11pt;
	font-weight:520;
	}
#QCheckBox::indicator::unchecked{ 
			width: 12px;  
            height: 12px;  
            border: 1px solid rgb(44,206,162);
            background-color:rgb(44,206,162)}
#QCheckBox::indicator::checked{ 
			width: 12px;  
             height: 12px;
             image:url(:res/tick.png);
             border: 1px solid rgb(44,206,162);
             background-color:rgb(44,206,162)}

这里我们需要一张:res/tick.png图片作为勾选后的样式，图片是用qrc转的。
tick.png下载地址：https://wwt.lanzoul.com/iwu9u1zxiehe

大致效果如下图：

6.多线程

这个问题对于新手来说可能不会涉及到，但是随着代码量和需求的叠加，难免会遇到这个问题：主线程（UI线程）耗时太久导致整个界面卡顿甚至卡死，在此我提供一种方案，就是多线程，但是多次的重写QThread会徒增代码量，我给出一种方案解决：

class WorkerThread(QThread):
	calc_finished = pyqtSignal(dict)

	def __init__(self, task, *arg, **args):
		super(WorkerThread, self).__init__()
		self.arg = arg
		self.args = args
		self.task = task

	def run(self):
		result = self.task(self, *self.arg, **self.args)

	def do_calc(self, **args):
		data=dict()
		try:
			data=xxx()
		except:
			traceback.print_exc()
		self.calc_finished .emit(data)

代码大致思路是创建一个线程类，里面通过定义不同的函数执行耗时操作，当耗时操作执行完毕后，使用“发射信号”的方式，将数据传递回主线程。

7.关于无边框

关于无边框将会介绍三种情况：无边框、无边框移动、无边框调整窗口宽高

1.设置无边框

在主窗口加入下面代码即可

self.setWindowFlag(Qt.FramelessWindowHint)

无边框可配合背景透明来用，效果比较好

self.setAttribute(Qt.WA_TranslucentBackground)

2.无边框窗口移动

当我们设置无边框后，窗口就被固定无法移动了，在此我提供一种方法，通过重写鼠标事件完成无边框窗口移动。
首先设置无边框

self.setWindowFlag(Qt.FramelessWindowHint)

然后加入重写事件

	# 无边框的拖动
	def mouseMoveEvent(self, e: QtGui.QMouseEvent):  # 重写移动事件
		try:
			self._endPos = e.pos() - self._startPos
			self.move(self.pos() + self._endPos)
		except (AttributeError, TypeError):
			pass

	def mousePressEvent(self, e: QtGui.QMouseEvent):
		if e.button() == Qt.LeftButton:
			self._isTracking = True
			self._startPos = QPoint(e.x(), e.y())

	def mouseReleaseEvent(self, e: QtGui.QMouseEvent):
		if e.button() == Qt.LeftButton:
			self._isTracking = False
			self._startPos = None
			self._endPos = None

	def keyPressEvent(self, event):
		if event.key() == Qt.Key_Escape:
			self.hide()

4.无边框窗口调整宽高

即使我们设置了窗口无边框、可拖动，但窗口大小是无法调整的，当然我们可以再次重写鼠标事件（判断鼠标位置，改变鼠标形状，重设窗口宽高），我提供一种简单的方法实现无边框窗口调整宽高。
在此提供一下思路：向窗口内加入QSizeGrip，此组件能够帮我们调整窗口的宽高，很是实用

size_grip = QSizeGrip(self.centralwidget)  # 加入右下角窗口大小调节器
self.verticalLayout_2.addWidget(size_grip, 0, Qt.AlignBottom | Qt.AlignRight)

效果见图

四．记录

本文会持续更新，大家点赞不迷路哈~

2024年5月27日更新1-6
2024年6月29日更新7