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 pformatclass 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临时启用(仅当前会话)
builtins.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_协议,可自定义对象的富文本展示 - 自动对
dict、list、numpy、pandas等对象做折叠+悬停展开 - 无需改代码,只需安装
IPython并用它启动交互式会话即可获得近似pprint的体验
不复杂但容易忽略:真正需要“自动折行 repr”的场景,绝大多数时候 pprint 就是标准解法;自定义类加 pformat 是干净的工程实践;全局替换适合临时调试;而 IPython 则让日常开发几乎不用操心这个问题。










