为何向reportlab的ParagraphStyle传入无效参数程序不崩溃？

一、ParagraphStyle不报错的原因 #

• ReportLab的样式类（包括ParagraphStyle）的构造方法（__init__）是用**可变关键字参数（**kwargs）**来接收所有传入参数的。
• 内部会维护一个预先定义的合法样式属性列表（比如fontSize、fontName这类规范的样式键），只对列表内的参数做赋值处理，完全忽略不在列表里的参数。
• 你传fontsize（小写）时，因为和预期的fontSize（驼峰命名）不匹配，被判定为未知参数直接跳过，所以字体大小不生效但程序不崩溃；传alanTuring="god"这种完全无关的参数也是同样被忽略，不会触发错误。

二、自定义Book类报错的原因 #

• 如果你没给Book类的__init__方法定义**kwargs参数，也没继承能处理额外参数的基类，Python会严格检查传入参数是否和方法定义的形参完全匹配。
• 当你传入未定义的参数时，Python找不到对应的形参来接收，就会直接抛出TypeError，提示“意外的关键字参数”。

直观的代码示例 #

模拟ParagraphStyle的实现逻辑 #

class MockParagraphStyle:
    def __init__(self, **kwargs):
        # 只处理预先定义好的合法样式参数
        valid_attrs = ['fontSize', 'fontName', 'leading']
        for attr in valid_attrs:
            if attr in kwargs:
                setattr(self, attr, kwargs[attr])
        # 其他所有参数直接忽略，不做处理

# 调用时传错或传未知参数都不会报错
ps = MockParagraphStyle(fontsize=12, alanTuring="god")
print(ps.__dict__)  # 输出空字典，因为fontsize不在valid_attrs里

自定义Book类的默认实现 #

class Book:
    def __init__(self, title, author):
        self.title = title
        self.author = author

# 传未定义参数会直接报错
b = Book(title="1984", author="Orwell", year=1949)  
# 抛出错误：TypeError: Book.__init__() got an unexpected keyword argument 'year'

核心差异总结 #

本质是两类类的参数设计理念不同：

• ReportLab的样式类为了灵活适配各种扩展场景，设计成兼容未知参数，只处理已知的样式属性；
• 自定义类默认遵循Python的严格参数匹配规则，只有显式声明的参数才能被接收，否则触发错误。

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