Jupyter Notebook中selected_options变量延迟更新问题求助

问题描述 #

运行以下代码时，print(selected_options)会显示为空，但在下方新单元格单独运行selected_options却能获取到填充的值。该变量仅在代码完全执行完毕后才会被填充，导致后续代码无法直接使用其值：

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

options = ['Option 1', 'Option 2', 'Option 3']
checkboxes = [widgets.Checkbox(description=option) for option in options]
checkboxes_container = widgets.VBox(checkboxes)
display(checkboxes_container)

selected_options = []

def show_selected_options(option):
    global selected_options
    if option['new']:
        selected_options.append(option['owner'].description)
    else:
        selected_options.remove(option['owner'].description)

for checkbox in checkboxes:
    checkbox.observe(show_selected_options, 'value')

while True:
    user_input1 = input("Enter 'done' ")
    if user_input1 == 'done':
        break
    else:
        selected_options.append(user_input1)


print(selected_options) #shows up empty

原因分析 #

核心问题是主线程被阻塞：

• ipywidgets的回调函数（如show_selected_options）依赖Jupyter Notebook的事件循环触发执行
• 代码中的while True循环搭配input()会完全卡住主线程，此时checkbox的状态变化事件无法被处理，回调函数根本没机会运行
• 直到输入done跳出循环、整个单元格代码执行完毕，Notebook的事件循环才会处理之前积累的所有checkbox事件，这时selected_options才会被填充，但print(selected_options)已经执行过了，所以打印为空；后续新单元格访问变量时，事件已处理完成，变量自然有值

解决办法 #

方法1：用ipywidgets按钮替代input()（推荐） #

这种方式不会阻塞主线程，符合ipywidgets的设计逻辑：

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

options = ['Option 1', 'Option 2', 'Option 3']
checkboxes = [widgets.Checkbox(description=option) for option in options]
checkboxes_container = widgets.VBox(checkboxes)
display(checkboxes_container)

selected_options = []

def show_selected_options(option):
    global selected_options
    desc = option['owner'].description
    # 增加判断避免重复操作报错
    if option['new']:
        if desc not in selected_options:
            selected_options.append(desc)
    else:
        if desc in selected_options:
            selected_options.remove(desc)

for checkbox in checkboxes:
    checkbox.observe(show_selected_options, 'value')

# 创建"完成"按钮替代input()
done_button = widgets.Button(description='完成')
display(done_button)

def handle_done_click(b):
    global selected_options
    # 在这里编写需要使用selected_options的后续逻辑
    print("最终选中的选项：", selected_options)
    # 可选：清理界面
    clear_output(wait=True)

done_button.on_click(handle_done_click)

方法2：手动在循环中处理事件循环（不推荐，仅作兼容） #

如果一定要保留input()，可以在循环中手动触发事件循环迭代，让checkbox回调有机会执行：

import ipywidgets as widgets
from IPython.display import display, clear_output
from IPython import get_ipython

options = ['Option 1', 'Option 2', 'Option 3']
checkboxes = [widgets.Checkbox(description=option) for option in options]
checkboxes_container = widgets.VBox(checkboxes)
display(checkboxes_container)

selected_options = []

def show_selected_options(option):
    global selected_options
    desc = option['owner'].description
    if option['new']:
        if desc not in selected_options:
            selected_options.append(desc)
    else:
        if desc in selected_options:
            selected_options.remove(desc)

for checkbox in checkboxes:
    checkbox.observe(show_selected_options, 'value')

while True:
    # 手动触发事件循环处理pending事件
    get_ipython().kernel.do_one_iteration()
    user_input1 = input("Enter 'done' ")
    if user_input1 == 'done':
        break
    else:
        selected_options.append(user_input1)

print(selected_options)

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