repr 如何自动折行显示超长对象(pprint 风格)

Python 默认 repr() 不折行,可用 pprint 替代实现自动折行缩进;自定义类中在 repr 内调用 pformat;调试时可临时替换 builtins.repr;IPython/Jupyter 自带智能美化。

Python 默认的 repr() 不会自动折行,遇到嵌套深、元素多的对象(比如大型字典、长列表、自定义类实例)时,输出挤在一行,难以阅读。要实现类似 pprint 的自动折行、缩进、结构化显示,不能直接“改造” repr,但有几种实用、轻量、即插即用的方式。

用 pprint 替代 repr(最直接)

pprint 本身就是为可读性设计的,支持自动折行、缩进、深度控制和宽度限制:

  • 使用 pprint.pprint(obj) 直接打印,带颜色(终端支持时)和换行
  • pprint.pformat(obj) 获取格式化后的字符串(可用于日志、调试输出)
  • 关键参数:width=80 控制每行最大字符数(默认 80),depth=3 限制嵌套深度,compact=True 让容器元素更紧凑(如 [1, 2, 3, ..., 99]

给类定义 __repr__ 时内嵌 pprint

如果你希望自定义类的 repr 行为自带折行效果,可在 __repr__ 中调用 pformat

from pprint import pformat

class Config: def init(self, **kwargs): self.dict.update(kwargs)

def __repr__(self):
    return f"{self.__class__.__name__}({pformat(self.__dict__, width=60, indent=2)})"

这样 repr(cfg)print(cfg) 都会输出结构清晰、自动折行的结果。

临时替换全局 repr(谨慎使用)

不推荐长期修改,但调试时可快速生效:把 builtins.repr 暂时指向 pprint.pformat(注意仅影响后续调用):

import builtins
import pprint

临时启用(仅当前会话)

builti

ns.repr = lambda x: pprint.pformat(x, width=70, depth=4)

现在 repr([1,2,3,...,100]) 就会折行了

⚠️ 注意:这会影响所有用到 repr 的地方(包括第三方库、异常回溯),退出前建议恢复:del builtins.repr 或重新导入。

用 IPython / Jupyter 自动美化

在交互式环境(IPython、Jupyter Notebook/Lab)中,默认已启用智能 repr

  • 支持 _repr_pretty_ 协议,可自定义对象的富文本展示
  • 自动对 dictlistnumpypandas 等对象做折叠+悬停展开
  • 无需改代码,只需安装 IPython 并用它启动交互式会话即可获得近似 pprint 的体验

不复杂但容易忽略:真正需要“自动折行 repr”的场景,绝大多数时候 pprint 就是标准解法;自定义类加 pformat 是干净的工程实践;全局替换适合临时调试;而 IPython 则让日常开发几乎不用操心这个问题。