Jupyter Notebook中display类在if-else块内无法显示的问题

问题背景 #

在Jupyter Notebook（.ipynb文件）中使用以下自定义display类展示DataFrame时，顶层调用display('df')能正常渲染表格，但放入if-else条件块内调用却没有任何输出。

自定义display类代码 #

# Handy class for DataFrame viz
class display(object):
    '''
    Display HTML representation of multiple objects
    '''
    
    template = '''<div style="float: left; padding: 10px;">
                  <p style='font-family:"Courier New", Courier, monospace'>{0}</p>{1}
                  </div>'''
    
    def __init__(self, *args):
        self.args = args
        
    def _repr_html_(self):
        return '\n'.join(self.template.format(a, eval(a)._repr_html_()) for a in self.args)
    
    def __repr__(self):
        return '\n\n'.join(a + '\n' + repr(eval(a)) for a in self.args)

复现代码 #

import pandas as pd
# 创建示例DataFrame
df = pd.DataFrame({
    'A': [1,2,3],'B':[4,5,6],'C':[7,8,9],'D':[10,11,12],'E':[13,14,15]
})
display('df') # 顶层调用正常显示
inside = True
if inside:
    display('df') # if块内调用无输出

核心原因 #

Jupyter Notebook的自动输出机制仅针对代码单元顶层的表达式语句：

• 顶层的display('df')是独立的表达式，Jupyter会自动捕获其返回值（自定义display类的实例），并调用实例的_repr_html_()方法生成HTML展示内容。
• 但在if（或for/while等）控制流块内部，即使执行了display('df')创建实例，Jupyter也不会主动捕获和渲染该实例的输出——控制流块内的代码执行结果不会被自动展示，必须显式触发输出逻辑。

另外注意：自定义类命名为display，与IPython自带的display()函数重名，可能会引发混淆，建议修改类名（比如MultiDataFrameDisplay）避免冲突。

解决办法 #

方法1：显式调用IPython的display函数 #

导入IPython自带的display工具（用别名避免冲突），主动输出自定义display实例：

from IPython.display import display as ipy_display

inside = True
if inside:
    ipy_display(display('df'))

方法2：将实例作为控制流块的顶层返回值（仅适用于块为cell最后逻辑时） #

如果if块是代码单元的最后一段逻辑，可以让自定义display实例成为块的最后一个表达式，Jupyter会捕获并显示该结果：

inside = True
if inside:
    # 让实例成为if块的最终表达式
    display('df')

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