函数参数和默认参数如何工作？

Question

函数参数和默认参数如何工作？

Accepted Answer

Python 函数支持 **positional** 和 **keyword** 参数，以及 **default values**。理解它们如何组合 — 以及一个著名的默认参数陷阱 — 是必不可少的。

## Positional、keyword 和默认参数

```python
def greet(name, greeting="Hello", punctuation="!"):
    return f"{greeting}, {name}{punctuation}"

greet("Ann")                          # positional → "Hello, Ann!"
greet("Ann", "Hi")                    # "Hi, Ann!"
greet("Ann", punctuation=".")          # keyword arg → "Hello, Ann."
greet(name="Ann", greeting="Hey")      # all by keyword
```

具有默认值的参数是可选的；你可以按位置或按名称（关键字参数）传递参数，关键字参数提高可读性，并让你跳过之前的可选参数。

## 著名陷阱：可变默认参数

```python
# ❌ DANGER — the default list is created ONCE and SHARED across all calls
def add_item(item, items=[]):
    items.append(item)
    return items

add_item("a")   # ["a"]
add_item("b")   # ["a", "b"]  ← surprise! the SAME list persisted
```

默认值在函数定义时 **计算一次**，而不是每次调用时。因此，可变默认值（list/dict）在调用之间被共享 — 这是一个经典的 bug。修复方法：

```python
# ✅ use None as the default and create a fresh object inside
def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items
```

## Keyword-only 和 positional-only 参数

```python
def f(a, b, *, key):       # `*` → `key` MUST be passed by keyword
    ...
f(1, 2, key=3)             # ✅   f(1, 2, 3) ❌

def g(a, b, /, c):         # `/` → a, b MUST be positional
    ...
```

`*` 和 `/` 标记让你强制参数的传递方式 — 对于清晰、稳定的 API 很有用。

## 为什么这很重要

理解参数处理对于正确编写和调用 Python 函数至关重要。

默认值使函数灵活，关键字参数使调用自我文档化。

most crucially，**mutable-default-argument 陷阱** 是 Python 最常见和最令人困惑的 bug 之一 — 知道默认值只计算一次（因此可变默认值在调用之间持续存在）和 `None`-sentinel 修复可以防止一整类微妙的错误。

这些知识支撑设计清晰、可预测的函数 API。