Jupyter Output组件未清除问题求助：下拉框切换输出堆叠

在Jupyter中使用ipywidgets实现下拉框组件，期望切换下拉框选项时显示对应的pandas DataFrame，但实际切换后，Output组件中的输出（如DataFrame、字典）会堆叠在一起，调用clear_output方法也无法解决该问题。ipywidgets版本为7.6.3，且该问题与pandas无关，输出字典时同样会出现堆叠现象。

复现问题的最小代码片段 #

import pandas as pd
from IPython.display import display, clear_output
import ipywidgets as widgets

out = widgets.Output()

w = widgets.Dropdown(
    options=['','one', 'two', 'three', 'four', 'five'],
    value='',
    description='Select:',
)

def on_change(change):
    if change['type'] == 'change' and change['name'] == 'value':
        
        print("changed to %s" % change['new'])  # 该日志能正常输出到控制台

        df = pd.DataFrame([change['new']], columns=['Selected'])
        clear_output(wait=False)  # 原本期望此方法能避免输出堆叠，但未生效
        out.append_display_data(df)

w.observe(on_change)

display(w, out)

问题原因与解决方案 #

问题核心在于：调用clear_output()时，默认清除的是当前单元格的输出区域，而非我们创建的out这个Output组件的内容。因此需要明确指定清除目标为out组件。

修正后的代码 #

import pandas as pd
from IPython.display import display, clear_output
import ipywidgets as widgets

out = widgets.Output()

w = widgets.Dropdown(
    options=['','one', 'two', 'three', 'four', 'five'],
    value='',
    description='Select:',
)

def on_change(change):
    if change['type'] == 'change' and change['name'] == 'value':
        
        print("changed to %s" % change['new'])

        df = pd.DataFrame([change['new']], columns=['Selected'])
        # 改为清除out组件的内容
        out.clear_output(wait=False)
        out.append_display_data(df)

w.observe(on_change)

display(w, out)

另一种更规范的写法（使用上下文管理器） #

也可以通过with out:上下文管理器来操作，确保所有输出都定向到out组件，同时清除原有内容：

import pandas as pd
from IPython.display import display, clear_output
import ipywidgets as widgets

out = widgets.Output()

w = widgets.Dropdown(
    options=['','one', 'two', 'three', 'four', 'five'],
    value='',
    description='Select:',
)

def on_change(change):
    if change['type'] == 'change' and change['name'] == 'value':
        
        print("changed to %s" % change['new'])

        df = pd.DataFrame([change['new']], columns=['Selected'])
        with out:
            clear_output(wait=False)
            display(df)

w.observe(on_change)

display(w, out)

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