如何用Jupyter Widgets更新Matplotlib图表，不生成新图表？

核心解决方案 #

要实现点击按钮更新图表数据且不生成新图表，关键是复用同一个Matplotlib图表对象（fig、ax），并通过刷新画布来更新显示，而非重新创建图表。以下是完整可运行的代码示例：

步骤1：配置环境与导入库

首先确保安装ipympl（支持交互式Matplotlib），并设置正确的后端：

# 安装ipympl（首次运行需执行）
!pip install ipympl

# 设置交互式Matplotlib后端，支持画布动态刷新
%matplotlib ipympl

import ipywidgets as widgets
import matplotlib.pyplot as plt
import numpy as np

步骤2：初始化图表与Output组件

创建全局的fig和ax，并将初始图表放入Output组件中：

# 创建唯一的图表对象，避免重复创建
fig, ax = plt.subplots(figsize=(6, 4))
# 初始绘制示例数据，保存线条对象用于后续更新
x_initial = np.linspace(0, 10, 100)
line, = ax.plot(x_initial, np.sin(x_initial), label="示例数据")
ax.set_title("可更新的图表")
ax.legend()

# 创建Output组件，用于显示图表
out = widgets.Output()

# 将初始图表输出到Output中
with out:
    plt.show(fig)

步骤3：编写按钮回调函数（更新逻辑）

在回调中直接修改已有线条的数据，刷新画布即可，无需重新创建图表：

def update_chart(b):
    # 这里替换为从文件读取数据的逻辑
    # 示例：生成新的随机数据
    new_x = np.linspace(0, 10, 100)
    new_y = np.cos(new_x) + np.random.randn(100)*0.1
    
    # 更新已有线条的数据，而非重新绘图
    line.set_data(new_x, new_y)
    
    # 自动调整坐标轴范围（如果数据范围变化）
    ax.relim()
    ax.autoscale_view()
    
    # 刷新画布，让Output中的图表更新
    fig.canvas.draw()
    fig.canvas.flush_events()

# 创建更新按钮并绑定回调
update_btn = widgets.Button(description="更新数据")
update_btn.on_click(update_chart)

# 显示按钮和图表组件
widgets.VBox([update_btn, out])

关键注意事项 #

• 复用图表对象：绝对不要在回调函数中重新创建fig和ax，否则每次点击都会生成新图表。
• 交互式后端：必须使用%matplotlib ipympl（或旧版%matplotlib notebook），否则静态后端无法支持画布刷新。
• 修改已有元素：绘图时保存line、bar等对象，直接调用其set_data()、set_height()等方法更新，而非重新调用ax.plot()。
• 刷新画布：修改数据后必须调用fig.canvas.draw()和fig.canvas.flush_events()触发显示更新。

解决跨单元格修改坐标轴属性不更新的问题 #

如果在其他Jupyter单元格中修改ax的属性（如标题、坐标轴标签），只需在修改后执行以下代码即可刷新显示：

ax.set_title("新的图表标题")
fig.canvas.draw()
fig.canvas.flush_events()

关于on_displayed方法 #

该方法已被ipywidgets弃用，无需再使用，直接通过with out:上下文将图表输出到组件中即可。

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