Как работают параметры функций и аргументы по умолчанию?

Question

Accepted Answer

Python функции поддерживают **позиционные** и **именованные** аргументы, а также **значения по умолчанию**. Понимание того, как они взаимодействуют — и одна известная ошибка с аргументами по умолчанию — является существенным.

## Позиционные, именованные и аргументы по умолчанию

```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
```

Значения по умолчанию вычисляются **один раз** при определении функции, а не при каждом вызове. Поэтому изменяемое значение по умолчанию (список/словарь) совместно используется между вызовами — классическая ошибка. Исправление:

```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
```

## Параметры только по имени и только по позиции

```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.

Значения по умолчанию делают функции гибкими, а именованные аргументы делают вызовы самодокументируемыми.

Критически важно, что **ловушка изменяемых аргументов по умолчанию** является одной из самых распространённых и запутанных ошибок Python — знание того, что значения по умолчанию вычисляются один раз (поэтому изменяемые значения по умолчанию сохраняются между вызовами) и исправление с использованием `None`-sentinel предотвращает целый класс тонких ошибок.

Это знание лежит в основе разработки чистого, предсказуемого API функций.