如何更新matplotlib显示窗口中的动态图表 解决plt.show()阻塞问题

原代码的核心阻塞问题 #

• plt.show()的设计逻辑是启动GUI事件循环后阻塞主线程，直到图表窗口被手动关闭才会返回执行权，原代码把它放在循环内部，第一次循环调用时就会卡住，后续的循环逻辑、打印语句、延时操作完全无法执行
• 缺少旧内容清理逻辑：如果直接把plt.show()移出循环，每轮绘制的新线条会直接叠加在之前的内容上，最终图表会被重叠的线条覆盖，无法实现单帧更新的效果
• 刷新流程顺序不合理：布局调整操作如果放在绘制内容之后、重绘之前调用，才能真正生效，原代码的布局调整顺序卡在重绘前但没有先清空内容，会出现布局错位的问题

具体调整步骤 #

1. 开启matplotlib交互模式，调用plt.ion()取消绘图的阻塞特性
2. 将plt.show()移到所有循环逻辑的最后，仅在循环结束后调用一次用于保持窗口常驻
3. 每轮循环绘制新内容前，对所有子轴调用ax.cla()清空旧的绘制内容
4. 调整刷新流程顺序：先清空轴、绘制新内容、调整布局、重绘画布、强制刷新UI事件，再执行延时等待
5. 固定的轴联动、基础样式这类不会随每轮更新变化的属性，放到循环外只初始化一次，减少重复计算开销

调整后的可运行代码 #

import matplotlib.pyplot as plt
import numpy as np
import time

# 开启交互模式，解除plt.show()的阻塞特性
plt.ion()

# 待展示的示例数据
x = np.linspace(0, 2 * np.pi, 400)
y = np.sin(x ** 2)

fig, axs = plt.subplots(2, 2)
# 轴的共享联动关系仅需初始化时设置一次
axs[1, 0].sharex(axs[0, 0])

i = 5
# 控制循环总次数，避免无限制刷新
for _ in range(100):
    # 批量清空所有子图的旧绘制内容
    for ax in axs.flat:
        ax.cla()

    axs[0, 0].plot(x[len(x) - i:], y[len(y) - i:])
    axs[0, 0].set_title("main")

    axs[1, 0].plot(x, y ** 2)
    axs[1, 0].set_title(f"shares {i} with main")

    axs[0, 1].plot(x + 1, y + 1)
    axs[0, 1].set_title("unrelated")

    axs[1, 1].plot(x + 2, y + 2)
    axs[1, 1].set_title("also unrelated")

    # 先调整布局，再执行重绘
    fig.tight_layout()
    fig.canvas.draw()
    fig.canvas.flush_events()

    i += 1
    print('该打印语句可正常输出，不会被窗口阻塞')
    time.sleep(0.5)

# 关闭交互模式，所有刷新完成后保持窗口不退出
plt.ioff()
plt.show()

注意事项 #

• 必须在初始化画布前开启plt.ion()交互模式，否则窗口可能无法正常渲染动态内容
• ax.cla()是避免线条堆叠的必要操作，如果希望保留历史绘制轨迹，也可以不调用清空，只更新需要变化的对应曲线对象的数据
• 如果使用VS Code、PyCharm的内置内嵌绘图后端，需要把matplotlib设置为独立窗口后端，否则动态刷新效果会失效
• fig.canvas.flush_events()的作用是强制将待渲染的UI内容推送到窗口，避免系统事件循环积压导致的刷新延迟

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