Python PySide2中单个QPainter使用报错与用法差异咨询

两种初始化写法的本质差异 #

Qt 的控件绘制操作是严格和paintEvent事件上下文绑定的：

• 只有在paintEvent执行期间，QWidget 对应的底层绘制引擎（paintEngine）才处于有效、可写入的状态。离开paintEvent之后，Qt 会自动回收当前帧的绘制缓冲区、销毁临时绘制上下文，任何绑定到旧上下文的QPainter都会自动失效。
• 在构造函数中初始化QPainter时，控件还未完成底层平台窗口资源创建，根本没有进入可绘制状态，这一步的初始化操作本身就是非法的。此时QPainter拿到的paintEngine指针是空的、无效的，后续等paintEvent真正触发时，这个提前创建的QPainter早就和当前帧的合法绘制上下文完全脱节，自然会报Painter not active错误，也画不出任何内容。
• 在paintEvent内部创建QPainter实例时，Qt会自动绑定当前帧有效的绘制引擎，初始化正确的绘制状态，等事件执行结束后自动完成资源回收，完全符合Qt的绘制调度逻辑，不会出现状态失效问题。

手动添加begin()/end()后仍有报错的原因 #

你看到的前两条报错，根源就在构造函数里的self.__painter = QtGui.QPainter(self)这行代码：
这行代码在控件还没就绪的时候就尝试获取绘制引擎，执行的瞬间就会触发paintEngine非法调用的报错，和你后续在paintEvent里加不加begin()/end()没有关系——报错在构造阶段就已经打出来了。

至于你观察到的“QPainter自动执行end()”的现象，本质上不是QPainter主动调用了end()，而是它之前绑定的绘制上下文在paintEvent结束后就被Qt回收销毁了，旧的绑定关系直接失效，和主动调用end()后的状态表现完全一致。

不推荐复用QPainter实例的核心原因 #

• QPainter本身是极轻量的对象，创建和销毁的开销可以忽略，完全没必要为了省这点性能做全局复用
• 每次绘制的上下文是独立的，复用QPainter很容易把上一次绘制设置的画笔、画刷、坐标变换、裁剪区域等状态残留到下一次绘制中，引发的渲染bug极难排查
• Qt 支持多种绘制后端（光栅、OpenGL、Vulkan等），不同帧的绘制缓冲区地址可能动态变化，拿着旧的QPainter实例写入，轻则绘制失败，重则直接触发程序崩溃。

正确写法示例 #

#! /usr/bin/env python3
import sys
from PySide2 import QtCore, QtGui, QtWidgets

class Canvas(QtWidgets.QWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 构造函数仅初始化业务数据，不创建任何绘制相关对象

    def paintEvent(self, event):
        # 每次绘制事件内部创建独立的QPainter实例
        painter = QtGui.QPainter(self)
        painter.eraseRect(0, 0, self.width(), self.height())
        painter.drawRect(20, 20, self.width() - 40, self.height() - 40)
        # 事件结束后painter自动销毁，无需手动管理

app = QtWidgets.QApplication()
win = QtWidgets.QMainWindow()
canvas = Canvas(win)
win.setCentralWidget(canvas)
win.show()
sys.exit(app.exec_())

内容的提问来源于stack exchange，提问作者Yann Dirson