PyQt QPainter最小绘图代码报错：Painter未激活问题及无重写paintEvent生成图形的快速方法

一、你遇到的错误原因 #

你碰到的QPainter::setRenderHint: Painter must be active to set rendering hints错误，核心问题很直白：QPainter在调用任何绘制相关的设置或操作前，必须先调用begin()方法绑定到一个绘制目标（比如你的QImage）。

看你原来的代码，创建painter = QtGui.QPainter()后直接就去设置渲染提示了，但这时候painter还处于未激活状态，根本没关联到要绘制的image上，所以Qt会抛出这个错误。

二、修正后的完整代码 #

我把你的代码调整了一下，修复了painter的问题，同时补全了实际运行必需的导入语句（你原代码没写，直接跑会报错），还加了填充白色背景的细节（不然导出的图片默认是黑色的）：

import sys
# 如果用PyQt5，把下面的导入改成：from PyQt5 import QtWidgets, QtGui, QtCore（QWidget在QtWidgets模块里）
from PyQt4 import QtGui, QtCore

WIDTH = 870  # mm
HEIGHT = 1170  # mm
DPI = 400
INCH = 25.4  # mm

if __name__ == '__main__':
    app = QtGui.QApplication(sys.argv)
    # GUI容器与视图设置
    window = QtGui.QWidget()
    scene = QtGui.QGraphicsScene(0, 0, WIDTH, HEIGHT)
    view = QtGui.QGraphicsView(window)
    view.setRenderHint(QtGui.QPainter.Antialiasing, True)
    view.setScene(scene)
    view.setFrameStyle(0)
    view.setFixedSize(WIDTH, HEIGHT)
    # 添加图形元素
    graphicItem = QtGui.QGraphicsEllipseItem(0, 0, 10, 10)
    scene.addItem(graphicItem)
    # 导出图片到本地
    img_width = int(WIDTH / INCH * DPI)
    img_height = int(HEIGHT / INCH * DPI)
    image = QtGui.QImage(img_width, img_height, QtGui.QImage.Format_RGB888)
    image.fill(QtCore.Qt.white)  # 填充白色背景
    
    painter = QtGui.QPainter()
    # 关键步骤：先调用begin绑定到image，激活painter
    if painter.begin(image):
        painter.setRenderHint(QtGui.QPainter.Antialiasing, True)
        targetrect = QtCore.QRectF(0, 0, img_width, img_height)
        scene.render(painter, targetrect)
        painter.end()
        image.save('example.png')
    
    window.show()
    sys.exit(app.exec_())

三、无需重写paintEvent的快速图形生成方法 #

其实你已经选对了最优路径：使用QGraphicsScene + QGraphicsView的组合，就是PyQt里无需自定义部件、快速生成图形的最佳方案。具体步骤很清晰：

• 创建QGraphicsScene作为图形容器，它负责管理所有图形元素的生命周期
• 创建QGraphicsView作为视图载体，用来展示scene里的内容
• 直接调用Qt预定义的图形项（比如QGraphicsEllipseItem、QGraphicsRectItem、QGraphicsLineItem等），添加到scene中即可
• 如果需要导出图片，就用scene.render()配合QPainter绘制到QImage上再保存，就像修正后的代码那样

这种方式的优势很明显：

• 不用自己重写paintEvent，Qt已经封装好了所有绘制逻辑
• 可以轻松添加、删除、拖拽图形元素，管理成本极低
• 天然支持视图缩放、平移等交互操作（如果需要的话）
• 导出图片的流程简洁，不需要额外的复杂处理

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