Jupyter控制台类渲染逻辑探究及可定制性问询

常规Python环境的__repr__行为 #

在标准Python控制台中，开发者可通过实现类的__repr__方法，完全控制对象在控制台、调试器中的输出形式：

>>> class A: 
...   def __repr__(self):
...     return 'foo'
... 
>>> a = A()
>>> a 
foo
>>> repr(a)
'foo'
>>> print(repr(a))
foo

该规则对类型本身同样生效：直接输入类型名，控制台会输出该类型的repr结果：

>>> list
<class 'list'>
>>> print(repr(list))
<class 'list'>

Jupyter/IPython的差异表现 #

但在Jupyter（含IPython控制台、Jupyter Notebook）中，渲染逻辑有所不同：普通对象仍遵循__repr__的输出规则，但类型对象会简化显示为名称，而非完整的repr结果：

In [1]: list
Out[1]: list

In [2]: print(repr(list))
<class 'list'>

Jupyter的具体渲染逻辑 #

核心判断逻辑：并非简单的type类型判断 #

你的猜想方向正确，但实际逻辑比单纯的isinstance(value, type)判断更细致：
IPython的格式化系统会对**所有类型对象（即继承自type的实例）**做特殊处理，但不是直接输出value.__name__，而是会根据类型的归属模块、嵌套关系输出更精准的名称。比如自定义模块中的类，会显示为mymodule.MyClass，而非仅MyClass。

可被开发者覆盖的逻辑 #

Jupyter/IPython的渲染系统支持开发者自定义覆盖，主要有两种方式：

1. 实现_repr_pretty_方法：这是IPython专用的美化显示方法，优先级高于__repr__。你可以给自定义类型（甚至type类本身）添加这个方法，自定义输出格式：

from IPython.lib.pretty import pretty

class MyClass:
    pass

# 给type类添加自定义显示逻辑
def type_repr_pretty(obj, printer, cycle):
    if cycle:
        printer.text(f"<cyclic type {obj.__name__}>")
    else:
        printer.text(f"[Custom Type: {obj.__module__}.{obj.__name__}]")

type._repr_pretty_ = type_repr_pretty

# 在IPython中输入MyClass，会显示 [Custom Type: __main__.MyClass]

2. 注册自定义格式化器：通过IPython的display_formatter注册特定类型的格式化函数，完全接管该类型的渲染逻辑：

from IPython import get_ipython

ip = get_ipython()
formatter = ip.display_formatter.formatters['text/plain']

# 给list类型注册自定义格式化逻辑
def format_list(obj, pp, cycle):
    pp.text(f"List with {len(obj)} elements")

formatter.for_type(list, format_list)

# 在IPython中输入[1,2,3]，会显示 List with 3 elements

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