def func(pos_only, /, pos_or_kw, *, kw_only, **kwargs):
pass
| 區段 | 語法 | 呼叫方式 | 說明 |
|---|---|---|---|
| 位置專用 | a, / | 僅位置 | Python 3.8+,強制位置傳遞 |
| 位置或關鍵字 | b, c=1 | 位置或關鍵字 | 最常見 |
| 可變位置 | *args | 收集多餘位置參數為 tuple | 慣用 args |
| 關鍵字專用 | *, d, e=2 | 僅關鍵字 | Python 3+,API 明確化 |
| 可變關鍵字 | **kwargs | 收集多餘關鍵字參數為 dict | 慣用 kwargs |
def demo(a, b=10, *args, kw_only, **kwargs):
print(f"a={a}, b={b}, args={args}, kw_only={kw_only}, kwargs={kwargs}")
demo(1) # TypeError: missing kw_only
demo(1, 2, 3, 4, kw_only=5) # a=1, b=2, args=(3,4), kw_only=5, kwargs={}
demo(1, 2, kw_only=3, extra=4) # a=1, b=2, args=(), kw_only=3, kwargs={'extra':4}
args = (1, 2, 3)
kwargs = {'kw_only': 4, 'extra': 5}
demo(*args, **kwargs) # 等同 demo(1,2,3, kw_only=4, extra=5)
*args, **kwargs 傳遞給下一層
def wrapper(*args, **kwargs):
return inner(*args, **kwargs) # 完整透傳
**kwargs 僅用於真正動態/擴充參數,文件化預期鍵名def fn(*args: int, **kwargs: str) -> NonePython 參數機制極具彈性:位置、預設、可變位置、關鍵字專用、可變關鍵字五大類組合出豐富呼叫語意。理解解包裝 (`*`, `**`) 與參數順序規則,是寫出清晰、可維護 API 的關鍵。