python函数参数带星号怎么区分?单星与双星的适用场景
- 2026年11月16日
- 39 次
一个签名里同时出现星号和双星号,该先看哪一边?这个问题只在限定方向之后才有意义:问的是定义端怎么排参数,还是调用端怎么把一包数据摊开。方向不说清,两种回答会互相打架。要区分python函数参数带星号,标准只有一条:单星接位置,双星接名字,写法在签名里的位置决定谁不能按位置传。
定义端多出来的实参,单星和双星各收哪一类
判断依据是实参的传递方式,不是参数叫什么名字。单星只接位置实参,多出来的按顺序塞进一个元组;双星只接关键字实参,多出来的按名字塞进一个字典。两者都不改变必填参数的个数,只决定装不下的那部分去哪。

def f(a, *args, **kwargs) 调用 f(1, 2, 3, x=4) 之后,args 是 (2, 3),kwargs 是 {'x': 4}。名字本身没有魔力,把 args 换成 rest 效果一样,起作用的是前面那个星号。
反过来,只写 def f(a, *args) 却在调用时传 x=4,报的是 TypeError: f() got an unexpected keyword argument 'x'。这条说明双星号不是可有可无的装饰,少了它,多余的关键字一个都进不来。
元组和字典的差别不只是类型。元组能按下标取,顺序就是调用时写的顺序;字典靠键取,键名对不上时取不到值,而多出来的键会一直留在字典里,直到函数体里被读到。
位置参数为什么排不到星号右边
解析函数定义时,一旦读到 *args 或者单独一个 *,后面所有形参立刻切换成只能按关键字传,这条顺序规则没有例外。写 def f(a, *args, b),调用 f(1, 2, 3) 不会把 3 给 b,而是 TypeError: f() missing 1 required keyword-only argument: 'b'。
代价是顺序被写死。位置参数必须在星号左边,反过来写 def f(*args, a) 语法上过得去,位置实参照样全被 args 吞掉,a 只能靠 f(a=1) 给,漏了就报 TypeError: f() missing 1 required keyword-only argument: 'a'。
3.8 之后还多了斜杠。def f(a, b, /, c) 里斜杠左边两个只能按位置传,连名字都不给用。它和星号经常同时出现,读签名时按「斜杠、普通参数、星号、双星号」分成四段,从左到右过一遍就不会乱。

四段里只有中间那段是默认形态,既能按位置也能按名字传。两端的斜杠和星号是限制器,一个封掉名字,一个封掉位置。
关键字参数被双星号接住之后去哪了
双星号收进来的是一个普通字典,键一定是字符串。调用时写 x=4,x 本身就是字符串,定义端不会出问题;会出问题的是把现成的字典摊开传。
f(**{'a': 1}) 等价于 f(a=1)。键不是字符串就被直接拦下,f(**{1: 2}) 给 TypeError: keywords must be strings。这个错抛在调用点,不在函数体里,顺着栈往下翻函数实现是找不到原因的。
同名键冲突也有明确提示。f(**{'a': 1}, **{'a': 2}) 得到 TypeError: f() got multiple values for keyword argument 'a'。它和位置参数那条只差一个词,位置那条没有 keyword,关键字这条有。
两个收集口的差别到这一步才完整:一个收顺序,一个收名字,取法也跟着类型走。
调用端的星号写在实参前面会怎样
定义端星号负责收,调用端星号负责放,python函数参数带星号在两边的作用正好相反。f(*seq) 把序列按位置摊开,f(**mapping) 把字典按关键字摊开,两个一起写就是 f(*seq, **mapping),包装函数里最常见的一行。
顺序和名字冲突会在这里集中爆发。def f(a, b) 调用 f(1, *[2], a=3),位置 1 已经占了 a,后面又来一个 a=3,解释器不让步:
def f(a, b):
return a, b
f(1, *[2], a=3)
跑完得到的是一行 TypeError: f() got multiple values for argument 'a',栈顶落在最后那行调用上,不在函数定义里。缺参数、多参数、重复赋值三种 TypeError 的措辞不同,从文案就能判断该改调用还是改签名。

流程里容易漏掉的是绑定这一步。位置实参先按顺序填,关键字实参再按名字填,两轮都落到同一个形参上就报重复赋值。转发层多包一层,这个判断发生在被调函数的入口,栈里看到的却是 wrapper 那一帧。
包装层里最容易错在哪
python函数参数带星号在包装层里的表现,跟直接写签名完全是两回事。装饰器里形参写成 *args, **kwargs,签名信息就全丢了。inspect.signature 读到的如果是 wrapper,返回的只有 (*args, **kwargs),参数名、默认值、keyword-only 一个都看不见。签名要跟着函数走,得挂上 functools.wraps。
想看清签名到底被解析成什么,直接把每个形参的类别打出来:
import inspect
def f(a, /, b, *args, c, **kwargs):
pass
sig = inspect.signature(f)
print(sig)
print(sig.parameters["c"].kind)
第一行是 (a, /, b, *args, c, **kwargs),斜杠和星号都被原样打印;第二行打印的是 KEYWORD_ONLY,就是 _ParameterKind 里那个成员;想要人类可读的名字,用 .kind.name.lower() 或 .description,c 的类别被标成只能按关键字传。
wraps 只搬元数据,不搬调用规则。原函数只收位置参数,wrapper 照样能接关键字,转发时才炸。所以我把校验放在原函数,或者在转发前用 inspect.signature(f).bind(*args, **kwargs) 先绑一次,绑不过就当场抛,栈顶停在 wrapper 里,比等被调函数报错快得多。
哪些接口不适合把参数摊开传
python函数参数带星号到了对外接口这一层,规矩要整个翻过来。斜杠的写法要 3.8 才有,3.7 及以前写 def f(a, /) 直接 SyntaxError。库要兼容老版本,斜杠就不能用;星号和双星号从 3.0 起就稳定,不受这条限制。
对外发布的函数不适合只留 *args, **kwargs。签名一摊开,IDE 补全、类型检查、文档生成全部失效,调用方得翻源码才知道能传什么。参数超过五六个、名字还会变的时候,收一个 dataclass 或者把关键字参数写死,维护成本低得多。
分界线落在调用方会不会读源码上:内部工具函数只有自己调,星号参数怎么摊都行;对外接口要给别人用,写全签名才成立。
团队约定公开接口必须写全签名的时候,这套摊开传就该停在这里:一个 **kwargs 让调用方多查一次源码,十个就是十次。
若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。
- PHP文件包含函数有哪些?include与require文件包含函数有什么区别? 2022-10-09
- 不小心删除了pip怎么办?Python如何重装pip? 2022-07-05
- PHP in_array()、array_search()、array_key_exists() 查找函数对比 2026-07-02
- python虚拟环境和主环境有什么区别,装包前我踩过的坑 2026-11-08
- mysql数据库备份与恢复选哪种?按数据量与停机窗口分两条路 2026-11-18
- Nginx 504 Gateway Timeout超时详解:原因与优化方案 2026-07-02
