ipywidgets组件无法显示：仅输出文本无交互按钮

你遇到的问题是因为ipywidgets的交互组件不能在普通Python脚本的终端环境中运行，普通终端无法渲染富交互UI，只会输出组件的文本描述信息。结合你的环境（Mac、Python3.12.7、conda），可以按以下步骤解决：

核心原因 #

ipywidgets依赖Jupyter生态的交互渲染能力，直接用python script.py运行脚本时，终端不支持渲染按钮这类交互组件，只能输出对象的字符串表示。

解决方案 #

1. 切换到Jupyter环境运行（推荐） #

将代码放到Jupyter Notebook或JupyterLab中执行：

• 启动Jupyter：在conda环境中运行jupyter notebook或jupyter lab
• 创建新的Notebook，粘贴你的代码并运行，此时会正常显示可点击的按钮。

修正后的Jupyter环境代码（去掉多余的死循环，Jupyter自带事件循环）：

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

def button_clicked(b):
    with output:
        clear_output()
        print("Button clicked!")

button = widgets.Button(description="Click Me")
output = widgets.Output()

button.on_click(button_clicked)
display(button, output)

2. 检查conda环境的ipywidgets安装完整性 #

如果Jupyter环境中仍无法显示，确保安装了完整的依赖：

• 安装ipywidgets及Jupyter扩展：

conda install -c conda-forge ipywidgets jupyterlab_widgets

• 启用经典Jupyter Notebook扩展（JupyterLab无需此步骤）：

jupyter nbextension enable --py widgetsnbextension

3. 脚本模式下的替代方案（不推荐） #

如果必须在脚本中运行，需要使用asyncio事件循环替换原有的死循环：

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

def button_clicked(b):
    with output:
        clear_output()
        print("Button clicked!")

button = widgets.Button(description="Click Me")
output = widgets.Output()

button.on_click(button_clicked)
display(button, output)

# 使用asyncio事件循环替代死循环
try:
    asyncio.get_event_loop().run_forever()
except KeyboardInterrupt:
    with output:
        print("Ended")

注意：脚本模式下的交互体验较差，部分终端可能仍无法正常渲染组件，优先推荐Jupyter环境。

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