PyQtGraph：如何优雅地从GraphicsLayoutWidget中移除绘图？

问题核心 #

你遇到的报错本质是：removeItem仅从界面上移除了PlotItem，但没同步更新GraphicsLayout内部维护的单元格占用记录（也就是你发现的win.ci.items和win.ci.rows）。后续调用addPlot时，布局引擎仍认为旧单元格被占用，导致冲突。

针对你的三个问题的解答 #

1. 你忽略了什么？
   忽略了GraphicsLayout的内部布局状态联动逻辑。addPlot在添加PlotItem的同时，会在布局网格系统中标记对应单元格为已占用；但removeItem并没有反向清除这个标记，导致布局状态和实际部件状态脱节。

2. 是否存在与addPlot对应的移除函数？如果没有，原因是什么？
   目前pyqtgraph没有提供直接匹配addPlot的removePlot函数。这大概率是因为GraphicsLayoutWidget最初的设计偏向静态、一次性布局场景，动态增删部件并非优先考虑的使用场景，需要用户手动同步布局状态。

3. 从GraphicsLayoutWidget中移除绘图的优雅方法是什么？
   正确的做法是移除PlotItem后，手动清理GraphicsLayout内部的单元格记录，同时更新布局行高信息。以下是修正后的可运行代码：

import pyqtgraph as pg
import numpy as np

app = pg.mkQApp("MWE")
win = pg.GraphicsLayoutWidget(show=True)

x = np.cos(np.linspace(0, 2*np.pi, 1000))
y = np.sin(np.linspace(0, 4*np.pi, 1000))

plots = []

def add_plot():
    p = win.addPlot(row=len(plots), col=0)
    plots.append(p)
    p.plot(x,y)

def remove_plot(i):
    if 0 <= i <= len(plots)-1:
        p = plots[i]
        # 获取绘图所在的单元格位置
        pos = win.ci.getItemPos(p)
        if pos is not None:
            row, col, _, _ = pos
            # 清除布局中对应单元格的记录
            del win.ci.items[(row, col)]
            # 移除无部件的行高记录
            if row in win.ci.rows and len(win.ci.rows[row]) == 1:
                del win.ci.rows[row]
        # 移除部件并清理资源
        win.removeItem(p)
        plots.pop(i)
        p.deleteLater()
        # 强制刷新布局
        win.ci.updateLayout()

add_plot()
add_plot()
add_plot()

remove_plot(1)

add_plot()

pg.exec()

如果你的场景需要频繁动态增删绘图，也可以换用QVBoxLayout结合PlotWidget的方案，这种方式的动态管理更直观，无需处理GraphicsLayout的内部状态：

import pyqtgraph as pg
import numpy as np
from PyQt5.QtWidgets import QVBoxLayout, QWidget

app = pg.mkQApp("Alternative MWE")
win = QWidget(show=True)
layout = QVBoxLayout(win)

x = np.cos(np.linspace(0, 2*np.pi, 1000))
y = np.sin(np.linspace(0, 4*np.pi, 1000))

plots = []

def add_plot():
    p = pg.PlotWidget()
    plots.append(p)
    p.plot(x,y)
    layout.addWidget(p)

def remove_plot(i):
    if 0 <= i <= len(plots)-1:
        p = plots[i]
        layout.removeWidget(p)
        plots.pop(i)
        p.deleteLater()

add_plot()
add_plot()
add_plot()

remove_plot(1)

add_plot()

pg.exec()

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