本文详解为何直接覆写 kwargs 参数会导致额外关键字参数丢失，并通过对比三段代码，阐明正确合并固定参数与可变关键字参数的方法。
本文详解为何直接覆写 **kwargs 参数会导致额外关键字参数丢失，并通过对比三段代码，阐明正确合并固定参数与可变关键字参数的方法。
在 Python 函数中，**kwargs 是接收任意数量关键字参数的惯用方式，其本质是一个已初始化的字典。初学者常误以为 **kwargs 仅是“占位符”，可在函数体内随意重新赋值——但这一操作会彻底丢弃调用时传入的所有动态键值对。下面以《Python Crash Course》第 8 章的汽车信息构造函数为例，深入剖析关键误区与最佳实践。
? 问题核心：**kwargs 不是空容器，而是实参字典
在代码 #1 中：
def make_car(manufacturer, model_name, **car_info):
car_info['manufacturer'] = manufacturer
car_info['model name'] = model_name
return car_info**car_info 在函数被调用时（如 make_car('subaru', 'outback', color='blue', tow_package=True)）自动接收 {'color': 'blue', 'tow_package': True}，再通过赋值将固定字段注入其中。最终返回的是一个融合了动态参数与固定字段的完整字典。
而在代码 #2 中：
立即学习“Python免费学习笔记（深入）”；
def make_car(manufacturer, model, **options):
options = { # ⚠️ 危险操作：覆盖原始 options 字典！
'manufacturer': manufacturer.title(),
'model': model.title(),
}
# 后续循环遍历的是新字典，原传入的 color/tow_package 已丢失
for option, value in options.items():
options[option] = value # 此处无实际作用，且 options 已非原始 kwargs
return options**options 虽然接收了 {'color': 'blue', 'tow_package': True}，但下一行 options = {...} 直接将其引用指向一个全新字典，原始传入的关键字参数被完全抛弃。因此输出仅有 manufacturer 和 model。
✅ 正确做法：分离存储，显式合并
代码 #3 提供了标准解法：
def make_car(manufacturer, model, **options):
"""Make a dictionary representing a car."""
car_dict = {
'manufacturer': manufacturer.title(),
'model': model.title(),
}
# 显式将 **options 中的键值对更新到新字典
car_dict.update(options) # 或用：for k, v in options.items(): car_dict[k] = v
return car_dict
my_outback = make_car('subaru', 'outback', color='blue', tow_package=True)
print(my_outback)
# 输出：{'manufacturer': 'Subaru', 'model': 'Outback', 'color': 'blue', 'tow_package': True}✅ 优势在于：
- 使用独立变量名（如 car_dict）避免混淆；
- **options 始终保持原始内容，用于后续合并；
- 逻辑清晰：先构建基础结构，再叠加动态属性。
? 注意事项与进阶建议
- 命名规范：**kwargs 的形参名应体现用途（如 **car_specs），而非泛用 **options；局部变量名需明确区分（如 result, car_profile）。
- 避免副作用：切勿对 **kwargs 字典原地修改（如 options.pop()），除非明确需要消耗参数——此时应先深拷贝或转为 dict(options)。
-
增强健壮性（可选）：可添加类型校验或默认值处理：
def make_car(manufacturer, model, **options): if not manufacturer or not model: raise ValueError("Manufacturer and model are required") car_dict = {'manufacturer': str(manufacturer).title(), 'model': str(model).title()} car_dict.update({k: v for k, v in options.items() if k not in ('manufacturer', 'model')}) return car_dict
掌握 **kwargs 的字典本质与生命周期，是编写灵活、可维护函数的关键一步。记住：它不是待填充的空白画布，而是一份已送达的参数快照——你需要的是整合，而非替换。
