Python含datetime/timedelta嵌套列表打印输出不可读repr的方案与设计原因咨询

这是Python从设计之初就确定的核心规范：

• __repr__方法的定位是无歧义、可复现，输出的内容需要让看到的人完整知晓对象的类型、所有核心参数，甚至可以直接复制输出还原出对应的对象，核心服务于调试场景。
• __str__方法的定位是面向人类阅读的简化输出，不追求信息完整性，只追求观感友好。

list、tuple这类聚合容器，本身承担着展示内部结构、辅助调试的作用，因此设计上会统一调用内部元素的__repr__，保证容器展开后的所有信息都是完整无歧义的。如果容器内部全用__str__做展示，很容易出现信息混淆——比如没法区分值是整数1还是字符串"1"，也没法看到带时区的datetime的完整时区配置，反而会降低调试效率。

你之前考虑的几个方案里，修改内置list行为、修改datetime模块内置方法的操作完全不推荐：这类全局修改会破坏Python默认的一致性，很容易影响项目中其他依赖默认repr逻辑的代码，排查问题成本极高，而且Python的内置对象多为C实现，修改操作在版本升级时兼容性很差，没有实用价值。
针对你的嵌套结构、同时需要控制台打印+日志输出的场景，更稳妥的方案有两个：

• 写递归结构的自定义格式化函数
  你之前尝试的单层列表推导式，没法处理元组嵌套的多层结构，只要把转换逻辑改成递归形式就能解决问题。核心逻辑就是遍历所有层级的结构，遇到list/tuple就递归处理内部元素，遇到datetime、timedelta对象就转成str()的友好格式，其他类型保留原有表示：

  from datetime import datetime, timedelta
  
  def humanize_structure(obj):
      # 递归处理列表、元组类容器
      if isinstance(obj, (list, tuple)):
          return type(obj)(humanize_structure(item) for item in obj)
      # 对datetime、timedelta转成友好的字符串格式
      if isinstance(obj, (datetime, timedelta)):
          return str(obj)
      # 其他类型保留原有表示
      return obj
  

  使用时只需要在打印时把原列表过一遍这个函数即可，输出的结构和原列表完全一致，不会破坏嵌套结构的可读性。
• 对接logging模块的自定义格式化流程
  你不需要每次写日志时手动调用格式化函数，只需要把上面的humanize_structure逻辑接入logging的输出流程即可，改一次全局配置，所有打日志的位置都能直接输出可读格式：

  import logging
  
  class HumanizeLogFormatter(logging.Formatter):
      def format(self, record):
          # 日志输出前对传入的消息对象做递归格式化
          record.msg = humanize_structure(record.msg)
          return super().format(record)
  
  # 初始化logger时替换默认格式化器
  stream_handler = logging.StreamHandler()
  stream_handler.setFormatter(HumanizeLogFormatter())
  logger = logging.getLogger()
  logger.addHandler(stream_handler)
  logger.setLevel(logging.INFO)
  

  配置完成后，哪怕你直接把原嵌套列表传给logger.info()，最终输出的内容也会自动把datetime、timedelta替换成友好格式，不需要在每一行日志代码里重复写转换逻辑。

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