Python类中__format__方法默认参数失效问题排查

当你使用f'{my_config_file}'这种不带格式说明符的f-string时，Python会显式传入空字符串''作为__format__方法的参数，完全覆盖了你定义的默认值'short'。这就是触发TypeError的核心原因——你的方法里空字符串既不匹配'short'也不匹配'long'，直接进入else分支抛出了异常。

这是Python格式化协议的明确规定：无论是否指定格式说明符，解释器都会向__format__传递一个明确的参数。省略格式说明符时，默认传递空字符串，而不会使用方法定义的默认参数值。

要解决这个问题，你需要在方法内部主动处理空字符串的情况，将其映射到你想要的默认格式上。比如修改方法逻辑：

def __format__(self, code=''):
    # 把空字符串或未指定的情况映射到short格式
    if code == '' or code == 'short':
        return f'Filename {self.filename}: {self.config}'
    elif code == 'long':
        string = f'{self.filename}'
        for key, value in self.config.items():
           string = string + f'\n{key}{self.sep}{value}'
        return string
    else:
        raise TypeError('Choose between short or long.')

你之前想到的if not code or code == 'short'能生效，本质也是因为空字符串在布尔判断中会被视为False，not code正好捕获了Python默认传入的空字符串，从而触发short格式的逻辑。

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