先生と生徒の会話形式で理解しよう

生徒

「先生、Pythonの関数で引数にデフォルト値をつけるってどういう意味ですか？」

先生

「デフォルト値とは、引数に何も指定しなかったときに自動で使われる値のことです。これがあると、関数を呼ぶときに全部の引数を毎回書かなくても便利ですよ。」

生徒

「なるほど。でも、どうやって書くんですか？それに気をつけることはありますか？」

先生

「具体的な書き方とベストプラクティス、注意点を順番に説明しますね。安心してください、初心者でも簡単ですよ！」

1. デフォルト引数とは？基本の仕組み

関数の引数にあらかじめ値をセットしておける機能です。たとえば、次のように書くと「言葉」を指定しなければ「こんにちは」が使われます。


def greet(message="こんにちは"):
    print(message)

greet()          # 引数なし → こんにちは
greet("やあ！")  # 引数あり → やあ！

このように、引数に値を渡さなくても動くので便利です。

2. デフォルト引数のメリット

関数を簡単に呼び出せる
何度も同じ値を渡す手間を減らせる
コードが読みやすく、ミスを減らせる

たとえば、よく使う設定値をデフォルトにしておけば、毎回指定しなくても良くなるため、コードがスッキリします。

3. デフォルト引数の書き方のルール

Pythonでは、デフォルト値を持つ引数は、必ず「デフォルト値を持たない引数の後」に書く必要があります。順番を間違えるとエラーになります。


def example(a, b=10):  # OK
    print(a, b)

def wrong_example(a=10, b):  # エラーになる書き方
    print(a, b)

なぜなら、Pythonは左から右に引数をチェックし、途中でデフォルト値のない引数があると混乱するからです。

4. ベストプラクティス：デフォルト引数を使うときの注意点

特に「リスト」や「辞書」などのmutable（ミュータブル）なオブジェクトをデフォルト値に使うとトラブルの原因になります。ミュータブルとは「変更可能なデータ」という意味です。

例を見てみましょう。


def add_item(item, items=[]):
    items.append(item)
    return items

print(add_item("リンゴ"))  # ['リンゴ']
print(add_item("バナナ"))  # ['リンゴ', 'バナナ'] ← 期待と違う動き！

この例では、デフォルトのリストが関数間で共有されてしまうため、追加したものが残り続けます。多くの初心者がここで混乱します。

5. ベストプラクティスの解決方法：Noneを使う

この問題を防ぐため、デフォルト値にNoneを使い、関数内で新しいリストや辞書を作る方法が推奨されます。


def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items

print(add_item("リンゴ"))  # ['リンゴ']
print(add_item("バナナ"))  # ['バナナ'] ← 正しく動く

これで毎回新しいリストが作られるため、前の呼び出しの影響を受けません。

6. デフォルト値に適した型や値の例

安全に使えるのは、intやfloat、str、bool、Noneなどの「変更されない（イミュータブル）」データです。例えば、数値や文字列のデフォルト値は問題ありません。


def multiply(value, factor=2):
    return value * factor

print(multiply(5))      # 10
print(multiply(5, 3))   # 15

7. まとめ（※別記事で作成）

Pythonの関数の引数にデフォルト値を設定することで、使いやすい関数が作れます。特にミュータブルなデフォルト値には注意し、Noneを使って安全に設計するのがベストプラクティスです。

まとめ

ここまで、Pythonにおける関数の引数にデフォルト値を設定する方法や、その際に気をつけるべき重要なポイント、そして現場で使われているベストプラクティスについて詳しく解説してきました。

Pythonのデフォルト引数は、関数の柔軟性を高め、呼び出し側のコードを簡潔に保つために非常に強力なツールです。日常的なプログラミングにおいて、特定のパラメータがほとんどの場合で同じ値をとる際、デフォルト値を設定しておくことで、開発効率は劇的に向上します。しかし、本記事で強調したように「ミュータブル（変更可能）なオブジェクト」をデフォルト値に設定してしまうという罠は、経験豊富なエンジニアでも時折足を取られる非常に有名な挙動です。

デフォルト引数の活用の鍵

関数の設計において、デフォルト引数を活用する際は「その値が不変（イミュータブル）であるか」を常に意識することが大切です。数値（int）、浮動小数点数（float）、文字列（str）、真偽値（bool）、そしてNoneなどは、安全に使用できる代表的な型です。これらを使う限り、意図しないデータの書き換えが発生する心配はありません。

一方で、リスト（list）や辞書（dict）をデフォルト値にしたい場合は、今回学んだ「Noneで初期化し、関数内部で空のオブジェクトを生成する」というパターンを徹底しましょう。この手法は、Pythonの公式ドキュメントでも推奨されている、もっとも標準的かつ安全な実装方法です。

サンプルプログラムによる総復習

最後に、学んだ知識を定着させるために、実践的なサンプルコードを振り返ってみましょう。ユーザー情報を登録する関数を想定し、オプション引数として設定情報を渡すケースです。


def create_user(username, email, roles=None, is_active=True):
    # リスト（ミュータブル）はNoneで受け取り、内部で初期化するのがベストプラクティス
    if roles is None:
        roles = []
    
    # ユーザー情報を辞書形式で返す
    user_info = {
        "name": username,
        "email": email,
        "roles": roles,
        "active": is_active
    }
    
    # 役割の追加（関数の呼び出しごとに独立しているか確認用）
    roles.append("guest")
    
    return user_info

# ケース1: 必須引数のみで呼び出し
user1 = create_user("Tanaka", "tanaka@example.com")

# ケース2: デフォルト値を上書きして呼び出し
user2 = create_user("Sato", "sato@example.com", roles=["admin"], is_active=False)

# ケース3: 再度、必須引数のみで呼び出し（user1の影響を受けないことを確認）
user3 = create_user("Suzuki", "suzuki@example.com")

print(f"User 1: {user1}")
print(f"User 2: {user2}")
print(f"User 3: {user3}")

上記のコードを実行すると、各ユーザーの roles が独立して管理されていることが分かります。


User 1: {'name': 'Tanaka', 'email': 'tanaka@example.com', 'roles': ['guest'], 'active': True}
User 2: {'name': 'Sato', 'email': 'sato@example.com', 'roles': ['admin', 'guest'], 'active': False}
User 3: {'name': 'Suzuki', 'email': 'suzuki@example.com', 'roles': ['guest'], 'active': True}

エンジニアとしてのステップアップに向けて

Pythonの引数の仕組みを正しく理解することは、単にエラーを防ぐだけでなく、他の開発者が読みやすい「クリーンなコード」を書く第一歩となります。引数の順番、デフォルト値の型、そしてミュータブルなオブジェクトの扱い。これらをマスターすることで、ライブラリ開発や大規模なシステム構築においても、バグの少ない堅牢なプログラムが書けるようになるはずです。

これからは、新しい関数を作るたびに「この引数はデフォルト値を持たせるべきか？」「その値の型は安全か？」と一歩立ち止まって考える習慣をつけてみてください。その積み重ねが、あなたのPythonプログラミングスキルを確実に引き上げてくれるでしょう。

先生と生徒の振り返り会話

生徒

「先生、ありがとうございました！デフォルト引数の使い方がかなりスッキリ整理できました。特にリストを空のまま items=[] って書いちゃいけない理由は、衝撃的でした……。」

先生

「ははは、そうですよね。あれはPythonを学び始めた人が必ずと言っていいほど通る道なんです。関数が定義されたときに一度だけリストが作られる、という仕組みを理解しておくのがコツですよ。」

生徒

「関数が呼ばれるたびにリセットされるわけじゃないんですね。だから None を使って、関数の中で if roles is None: みたいに判定してあげるのが正解なんだと納得しました。」

先生

「その通りです！よく理解できましたね。あと、引数の順番についても覚えていますか？」

生徒

「もちろんです！デフォルト値がある引数は、必ず最後の方にまとめないといけないんですよね。試しに逆に書いてみたら、Pythonに『Non-default argument follows default argument』って怒られちゃいました。」