萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 函式參數完整解析:位置、預設、*args、**kwargs 與關鍵字專用參數

參數類型總覽


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)  # 完整透傳

最佳實務

  • 公開 API 盡量使用關鍵字專用參數 (`*, kw_only`),避免呼叫端順序錯誤
  • **kwargs 僅用於真正動態/擴充參數,文件化預期鍵名
  • 避免同時使用 `*args` 和多個位置參數造成混淆
  • 型別提示:def fn(*args: int, **kwargs: str) -> None

總結

Python 參數機制極具彈性:位置、預設、可變位置、關鍵字專用、可變關鍵字五大類組合出豐富呼叫語意。理解解包裝 (`*`, `**`) 與參數順序規則,是寫出清晰、可維護 API 的關鍵。

copyright © 萬盛學電腦網 all rights reserved