QPainter无法绘制：使用self.lines变量绘线失败，手动传值正常

嘿，我来帮你排查这个QPainter绘制线条的问题！你说手动传值能正常绘制，但用self.lines就失败，大概率是这几个环节出了问题，咱们一步步捋：

1. 确认self.lines的初始化与元素类型 #

首先得保证self.lines是存储QLineF对象的列表，而且在绘制前已经被正确初始化和赋值：

• 一定要在__init__里先把它初始化为空列表：

  self.lines = []
  

• 后续添加线条时，要确保存入的是QLineF实例，比如：

  # 示例：添加一条从(10,10)到(100,100)的线
  self.lines.append(QLineF(QPoint(10,10), QPoint(100,100)))
  

要是你存的是普通坐标元组（比如(10,10,100,100)），QPainter的drawLine/drawLines是识别不了的，得先转成QLineF再存储。

2. 检查paintEvent的实现是否正确 #

重写paintEvent时，要确保逻辑正确：

• 先调用父类的paintEvent，保证窗口基础绘制正常；
• 正确初始化QPainter并设置画笔；
• 遍历self.lines绘制每条线，或者用drawLines批量绘制（更高效）。

正确的paintEvent示例：

def paintEvent(self, event):
    super().paintEvent(event)  # 先完成父类的基础绘制
    painter = QPainter(self)
    # 设置画笔样式：红色，2px宽度
    pen = QPen(Qt.red, 2, Qt.SolidLine)
    painter.setPen(pen)
    
    # 方式1：遍历绘制每条线
    for line in self.lines:
        painter.drawLine(line)
    
    # 方式2：批量绘制所有线条（推荐，性能更好）
    # painter.drawLines(self.lines)

要是你没调用super().paintEvent(event)，或者QPainter的作用域处理不当，都可能导致绘制失效。

3. 修改self.lines后必须触发界面更新 #

当你给self.lines添加/修改线条后，一定要调用self.update()来触发paintEvent重新绘制界面。比如在按钮点击事件里添加线条：

def add_line(self):
    # 按你的逻辑添加线条
    self.lines.append(QLineF(QPoint(50,50), QPoint(200,200)))
    self.update()  # 关键！没有这一步，界面不会刷新显示新线条

要是忘了调用self.update()，就算self.lines里有内容，界面也不会重新渲染，看起来就像没画出来一样。

完整可运行示例代码 #

给你一个能正常工作的完整代码，你可以对比自己的代码找差异：

import sys
from random import randint
from PyQt5.QtWidgets import (QApplication, QWidget, QPushButton, QHBoxLayout)
from PyQt5.QtGui import (QPainter, QPen)
from PyQt5.QtCore import (Qt, QPoint, QLineF)

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()
        # 初始化线条列表
        self.lines = []
        # 先添加一条测试线
        self.lines.append(QLineF(QPoint(10,10), QPoint(100,100)))

    def init_ui(self):
        self.setWindowTitle("QPainter Lines Test")
        self.resize(400, 300)
        
        # 添加按钮用来新增线条
        add_btn = QPushButton("Add Random Line", self)
        add_btn.clicked.connect(self.add_random_line)
        
        layout = QHBoxLayout()
        layout.addWidget(add_btn)
        self.setLayout(layout)

    def add_random_line(self):
        # 生成随机坐标的线条
        x1, y1 = randint(0, self.width()), randint(0, self.height())
        x2, y2 = randint(0, self.width()), randint(0, self.height())
        self.lines.append(QLineF(QPoint(x1,y1), QPoint(x2,y2)))
        # 触发界面更新
        self.update()

    def paintEvent(self, event):
        super().paintEvent(event)
        painter = QPainter(self)
        pen = QPen(Qt.blue, 2, Qt.SolidLine)
        painter.setPen(pen)
        # 批量绘制所有线条
        painter.drawLines(self.lines)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

你可以运行这段代码，点击按钮就能看到随机线条被绘制出来，对照自己的代码看看是不是某个环节遗漏了~

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