本文详解为何在函数中直接重赋值 **kwargs 参数会导致额外键丢失，并通过对比三个版本的 make_car() 函数，阐明正确合并固定参数与可变关键字参数的核心原则。
本文详解为何在函数中直接重赋值 `**kwargs` 参数会导致额外键丢失，并通过对比三个版本的 `make_car()` 函数，阐明正确合并固定参数与可变关键字参数的核心原则。
在 Python 函数设计中，**kwargs 是处理任意数量关键字参数的常用机制，常用于构建灵活的数据结构（如字典）。但一个常见误区是：误将 `kwargs` 形参名直接用作新字典变量名并重新赋值**——这会导致原始传入的关键字参数被完全丢弃。
下面以构建汽车信息字典为例，逐层解析问题本质：
✅ 正确做法：复用 **kwargs 字典并扩展（代码 #1）
def make_car(manufacturer, model_name, **car_info): car_info['manufacturer'] = manufacturer car_info['model name'] = model_name return car_info car = make_car('subaru', 'outback', color='blue', tow_package=True) print(car) # 输出: {'color': 'blue', 'tow_package': True, 'manufacturer': 'subaru', 'model name': 'outback'}
✅ 关键点：car_info 是由 **car_info 自动收集的字典，我们直接在其上添加键值对，保留了所有传入的额外参数（color, tow_package）。
❌ 错误做法：覆盖 **kwargs 变量（代码 #2）
def make_car(manufacturer, model, **options): options = { # ⚠️ 危险！此处用新字典覆盖了原 options 参数 'manufacturer': manufacturer.title(), 'model': model.title(), } # 下面的 for 循环遍历的是这个新字典，而非传入的 kwargs！ for option, value in options.items(): options[option] = value # 无实际作用，且 options 已不含 color/tow_package return options
❌ 根本问题：options = {…} 这一行切断了与原始 `options字典的关联**。Python 中**options在函数入口处自动打包为字典并绑定到局部变量options，但一旦执行options = {…}，该变量就指向一个全新对象，原传入的color=’blue’` 等键彻底丢失。
立即学习“Python免费学习笔记（深入）”；
? 补充说明：后续 for option, value in options.items(): 实际遍历的是刚创建的两元素字典，循环体中的赋值 options[option] = value 属于冗余操作，对结果无影响。
✅ 推荐写法：使用独立变量名，显式合并（代码 #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），避免混淆；
- update() 方法安全、简洁地合并字典；
- 逻辑分离：固定字段初始化 + 动态字段注入，可读性与可维护性更高。
? 最佳实践总结
- 永不重赋值 `kwargs形参名**：如**options，就不要写options = {…}`；
- 优先使用新变量名：如 result, car_info, config 等，明确其用途；
- 合并策略推荐：
- dict1.update(dict2) —— 原地更新，适合简单场景；
- {**dict1, **dict2} —— 创建新字典（Python 3.5+），更函数式；
- collections.ChainMap —— 需要延迟合并或避免内存拷贝时使用；
- 注意键冲突：若 **kwargs 中包含 ‘manufacturer’，它会覆盖函数内设置的值（取决于合并顺序），必要时应增加校验逻辑。
掌握这一细节，不仅能写出健壮的参数处理函数，更是理解 Python 对象绑定与变量作用域的重要实践。