함수 매개변수와 기본 인수는 어떻게 동작하나요?

Question

Accepted Answer

Python 함수는 **위치(positional)** 인수와 **키워드(keyword)** 인수, 그리고 **기본값(default value)**을 지원합니다. 이들이 어떻게 결합되는지 — 그리고 유명한 기본 인수 함정 하나 — 를 이해하는 것은 필수적입니다.

## 위치, 키워드, 기본 인수

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

greet("Ann")                          # 위치 → "Hello, Ann!"
greet("Ann", "Hi")                    # "Hi, Ann!"
greet("Ann", punctuation=".")          # 키워드 인수 → "Hello, Ann."
greet(name="Ann", greeting="Hey")      # 모두 키워드로
```

기본값이 있는 매개변수는 선택적입니다. 인수를 위치나 이름으로 전달할 수 있습니다(키워드 인수는 가독성을 높이고 앞쪽의 선택적 매개변수를 건너뛸 수 있게 합니다).

## 유명한 함정: 가변 기본 인수

```python
# ❌ 위험 — 기본 리스트는 한 번만 생성되어 모든 호출에서 공유됨
def add_item(item, items=[]):
    items.append(item)
    return items

add_item("a")   # ["a"]
add_item("b")   # ["a", "b"]  ← 놀랍게도! 동일한 리스트가 유지됨
```

기본값은 함수가 정의될 때 **한 번** 평가되며, 호출할 때마다가 아닙니다. 따라서 가변 기본값(list/dict)은 호출 간에 공유됩니다 — 고전적인 버그입니다. 해결책:

```python
# ✅ 기본값으로 None을 사용하고 내부에서 새 객체를 생성
def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items
```

## 키워드 전용 및 위치 전용 매개변수

```python
def f(a, b, *, key):       # `*` → `key`는 반드시 키워드로 전달해야 함
    ...
f(1, 2, key=3)             # ✅   f(1, 2, 3) ❌

def g(a, b, /, c):         # `/` → a, b는 반드시 위치로 전달해야 함
    ...
```

`*`와 `/` 표시는 인수가 전달되는 방식을 강제할 수 있게 합니다 — 명확하고 안정적인 API에 유용합니다.

## 왜 중요한가

매개변수 처리를 이해하는 것은 Python 함수를 올바르게 작성하고 호출하는 데 기본적입니다.

기본값은 함수를 유연하게 만들고, 키워드 인수는 호출을 자체 문서화되게 만듭니다.

결정적으로, **가변 기본 인수 함정**은 Python에서 가장 흔하고 혼란스러운 버그 중 하나입니다 — 기본값이 한 번만 평가된다는 것(따라서 가변 기본값이 호출 간에 유지됨)과 `None` 센티넬 해결책을 아는 것은 일련의 미묘한 오류를 예방합니다.

이 지식은 깔끔하고 예측 가능한 함수 API를 설계하는 기반이 됩니다.