QPixmap.fromImage生成图像显示损坏问题咨询（PyQt6）

问题现象 #

运行以下PyQt6代码时，生成的图像显示损坏：Windows系统下必现该问题，macOS系统下偶现。

损坏代码示例：

from PyQt6.QtCore import Qt
from PyQt6.QtGui import QImage, QPixmap
from PyQt6.QtWidgets import QWidget, QApplication, QLabel, QVBoxLayout

app = QApplication([])
window = QWidget()
window.resize(200, 200)

picture_view = QLabel('Image View')

def wrap():
    qimage = QImage(b"\x00\x00\xff\xff"*200*200, 200, 200, QImage.Format.Format_RGB32)
    return QPixmap.fromImage(qimage)
pixmap = wrap()
picture_view.setPixmap(pixmap)

layout = QVBoxLayout(window)
layout.addWidget(picture_view)

window.show()
app.exec()

（损坏效果：图像显示错乱，出现异常色块）

若移除wrap()函数，将QImage创建逻辑直接放在外部，图像显示恢复正常：

qimage = QImage(b"\x00\x00\xff\xff"*200*200, 200, 200, QImage.Format.Format_RGB32)
pixmap = QPixmap.fromImage(qimage)
picture_view.setPixmap(pixmap)

（正常效果：图像显示为预期的正确图案）

问题解答 #

1. 这是PyQt6的bug还是代码违反规则？ #

这不是PyQt6的bug，是代码违反了Qt的内存管理规则。当使用直接传入原始字节数据的QImage构造函数时，QImage默认不会复制这份数据，而是直接持有对原始内存的引用。在wrap()函数中，qimage是局部变量，函数执行完毕后会被Python垃圾回收机制销毁，其引用的原始字节数据也会被释放，导致后续QPixmap引用的内存失效，进而出现图像损坏。

2. 能否保留wrap()函数结构解决问题？ #

可以，有两种可行方案：

• 方案一：让QImage复制原始数据
  修改wrap()函数，创建QImage后调用copy()方法，确保QPixmap拿到的是独立、不会被回收的数据：

  def wrap():
      qimage = QImage(b"\x00\x00\xff\xff"*200*200, 200, 200, QImage.Format.Format_RGB32)
      return QPixmap.fromImage(qimage.copy())
  

• 方案二：保留QImage的持久引用
  在函数外部保留对qimage的引用，避免其被垃圾回收：

  global_qimage = None
  def wrap():
      global global_qimage
      global_qimage = QImage(b"\x00\x00\xff\xff"*200*200, 200, 200, QImage.Format.Format_RGB32)
      return QPixmap.fromImage(global_qimage)
  

3. 是否必须保留QImage实例才能确保QPixmap正常显示？ #

不一定，关键在于QPixmap是否持有独立的图像数据副本：

• 如果QPixmap.fromImage()接收的是QImage的副本（比如调用qimage.copy()后转换），则不需要保留原QImage实例；
• 如果QPixmap只是引用QImage的原始数据（默认情况，尤其是直接内存构造的QImage），则必须保留QImage实例，直到QPixmap不再需要这份数据。

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