单星号用于解包可迭代对象(如列表、元组),双星号专用于解包字典为关键字参数;不能直接解包字典,否则报TypeError;要求字典键必须是合法字符串标识符;函数定义中和*语义不同,前者引出仅限关键字参数,后者收集多余关键字参数。

解包列表、元组时用单星号 *,但不能直接解包字典
单星号 * 用于解包可迭代对象(如 list、tuple、range),把元素逐个“摊开”成位置参数或并列变量。常见错误是试图用 * 直接解包字典——它会报 TypeError: unhashable type: 'dict',因为字典本身不可哈希,且 * 不识别键值对结构。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 函数调用时:若
args = [1, 2, 3],写func(*args)等价于func(1, 2, 3) - 变量赋值时:支持“扩展解包”,如
a, *middle, z = [1, 2, 3, 4, 5]→middle得到[2, 3, 4] - 合并列表更简洁:
[*list1, *list2]比list1 + list2更直观,尤其含嵌套或需过滤时 - 注意:解包对象必须是可迭代的;空列表
[]解包后不产生任何元素,不会报错
传参给函数时,** 只能解包映射类对象(如 dict),且键名必须是合法关键字参数名
** 的作用是将字典的键值对展开为关键字参数。它不接受非字符串键(比如数字或元组作 key),也不允许键名与 Python 关键字冲突(如 {"class": "A"} 传给普通函数会触发 SyntaxError 或运行时报 TypeError)。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 确保字典键全为字符串,且是合法标识符(可用
str.isidentifier()预检) - 函数定义中用
**kwargs接收,但调用时**后必须跟一个映射对象,不能是生成器或dict_items - 组合使用
*和**时顺序固定:func(*args, **kwargs),颠倒会报SyntaxError - 常见误用:写
func(**{"a-b": 1})→ 键含短横线,不是合法参数名,会报TypeError: func() got an unexpected keyword argument 'a-b'
在函数定义中用 * 和 ** 收集参数,语义和限制完全不同
定义函数时,* 后的参数变成“仅限关键字参数”(keyword-only),而 **kwargs 是收集所有未匹配的关键字参数。两者不是对称操作——* 在定义中不表示解包,而是强制调用方必须用关键字传参。
实操建议:
立即学习“Python免费学习笔记(深入)”;
-
def f(a, *, b, c):→ 调用必须写f(1, b=2, c=3);f(1, 2, 3)会报错 -
def f(*args, **kwargs):中,args是 tuple,kwargs是 dict;但*args会吃掉所有位置参数,包括本该进**kwargs的键值对(除非显式用关键字) - 混合定义如
def f(a, *b, c, **d):是合法的:a 是必填位置参数,b 收集剩余位置参数,c 是仅限关键字参数,d 收集额外关键字参数 - 注意:
*单独出现(无变量名)可用于禁止位置参数,如def f(*, a, b):
嵌套解包和表达式中混用 */** 容易忽略语法限制
Python 不允许在任意上下文中自由解包。例如列表推导式里不能直接写 [*x for x in y],字典字面量中 ** 必须紧跟在另一个字典或映射之后,不能隔表达式。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 字典合并写法:
{**d1, **d2}合法,但{**d1, "k": v, **d2}也合法(Python 3.5+),不过重复键以右边为准 - 禁止写:
[*range(3), *[4, 5]]是合法的,但[*range(3), *x for x in [[6,7]]]语法错误——解包不能和 for 混在同一个列表推导里 - 集合/元组解包同理:
{*s1, *s2}可以,但(*a, *b)在函数调用外需加括号明确为元组,否则解析失败 - 最易被忽略的一点:解包操作不支持嵌套解包语法,比如
**{**d}是冗余且非法的,会报SyntaxError: invalid syntax
** 传入函数,却没校验 key 是否合法;或者用 * 解包一个可能为空的查询结果,导致变量绑定数量不匹配。这些地方得加 guard,不能只靠语法糖兜底。











