在Spyder中使用PyQtGraph时的内核异常问题

我之前在Spyder 5.x版本搭配PyQtGraph时也遇到过一模一样的问题——关闭绘图窗口后内核挂着不结束，重启内核再跑直接卡死，必须重启Spyder才行。这个问题的核心原因确实是Spyder本身就是一个Qt应用，后台已经存在一个QApplication实例，我们自己再创建新的实例会导致Qt资源冲突，关闭窗口后这些资源没法被正确回收，进而污染内核环境。

下面是经过验证的解决方法，分代码修改和Spyder配置调整两部分：

一、修改PyQtGraph代码适配Spyder环境 #

关键是复用Spyder已有的QApplication实例，而不是新建，同时确保窗口关闭时清理所有Qt资源：

1. 替换QApplication创建逻辑
   把原来的QApplication初始化代码：

app = QtGui.QApplication([])

改成优先复用已有实例的写法：

# 优先复用Spyder后台已有的QApplication实例
app = QtGui.QApplication.instance()
if app is None:
    app = QtGui.QApplication([])

2. 添加窗口关闭的资源清理逻辑
   给绘图窗口绑定关闭事件处理，确保定时器、绘图资源被彻底清理，避免内核残留线程：

# 自定义窗口关闭时的清理逻辑
def closeEvent(event):
    timer.stop()  # 停止数据更新定时器
    for curve in curves:
        curve.clear()  # 逐个清理曲线数据
    plot.clear()  # 清空绘图项
    event.accept()

# 把清理逻辑绑定到plot窗口的关闭事件上
plot.closeEvent = closeEvent

3. 优化主循环判断
   因为我们已经复用了Spyder的QApplication，不需要再重复启动独立的事件循环，修改主循环判断逻辑：

if __name__ == '__main__':
    import sys
    # 仅在非Spyder交互环境下才启动事件循环
    if not (sys.flags.interactive or hasattr(QtCore, 'PYQT_VERSION')):
        app.exec_()

修改后的完整可运行代码：

from pyqtgraph.Qt import QtGui, QtCore
import numpy as np
import pyqtgraph as pg
from pyqtgraph.ptime import time

# 复用已有QApplication实例
app = QtGui.QApplication.instance()
if app is None:
    app = QtGui.QApplication([])

plot = pg.plot()
plot.setWindowTitle('pyqtgraph example: MultiPlotSpeedTest')
plot.setLabel('bottom', 'Index', units='B')
nPlots = 100
nSamples = 500
curves = []
for idx in range(nPlots):
    curve = pg.PlotCurveItem(pen=(idx,nPlots*1.3))
    plot.addItem(curve)
    curve.setPos(0,idx*6)
    curves.append(curve)
plot.setYRange(0, nPlots*6)
plot.setXRange(0, nSamples)
plot.resize(600,900)
rgn = pg.LinearRegionItem([nSamples/5.,nSamples/3.])
plot.addItem(rgn)

data = np.random.normal(size=(nPlots*23,nSamples))
ptr = 0
lastTime = time()
fps = None
count = 0

def update():
    global curve, data, ptr, plot, lastTime, fps, nPlots, count
    count += 1
    for i in range(nPlots):
        curves[i].setData(data[(ptr+i)%data.shape[0]])
    ptr += nPlots
    now = time()
    dt = now - lastTime
    lastTime = now
    if fps is None:
        fps = 1.0/dt
    else:
        s = np.clip(dt*3., 0, 1)
        fps = fps * (1-s) + (1.0/dt) * s
    plot.setTitle('%0.2f fps' % fps)

timer = QtCore.QTimer()
timer.timeout.connect(update)
timer.start(0)

# 添加关闭事件处理
def closeEvent(event):
    timer.stop()
    for curve in curves:
        curve.clear()
    plot.clear()
    event.accept()

plot.closeEvent = closeEvent

## Start Qt event loop unless running in interactive mode.
if __name__ == '__main__':
    import sys
    if not (sys.flags.interactive or hasattr(QtCore, 'PYQT_VERSION')):
        app.exec_()

二、调整Spyder的配置 #

除了代码修改，还需要确保Spyder的图形后端和PyQtGraph兼容：

• 打开Spyder的Preferences（偏好设置）
• 进入IPython console → Graphics选项卡
• 在Graphics backend下拉菜单中选择Qt5（手动指定比Automatic更稳妥）
• 勾选Enable GUI event loop integration，确保Spyder的Qt事件循环和代码兼容
• 重启Spyder让配置生效

额外小技巧 #

如果偶尔还是出现内核卡死的情况，可以尝试：

• 运行代码前先在IPython控制台输入%reset -f清空内核变量
• 选择Spyder的Run菜单 → Run in external system terminal运行脚本，完全隔离Spyder的Qt环境，避免冲突

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