Pythonのデフォルト引数とは？基本から注意点・活用法まで徹底解説！

By 佐川 直弘 | Naohiro Sagawa (運営者)

※記事内に広告を含みます。Amazonアソシエイトとして適格販売により収入を得ています。

1. Pythonのデフォルト引数とは？【初心者向けにやさしく解説】

Pythonの関数を使う際、すべての引数に値を渡すのは面倒な場合があります。そのようなときに役立つのがデフォルト引数です。デフォルト引数を設定すると、関数呼び出し時に引数を省略でき、より簡潔で柔軟なコードを書くことができます。ここでは、デフォルト引数の基本概念とその使い方を解説します。

1.1 デフォルト引数とは？

Pythonの関数では、引数にデフォルト値（初期値）を設定することが可能です。これを「デフォルト引数」と呼びます。デフォルト引数を持つ関数を定義すると、関数を呼び出す際に特定の引数を省略でき、その場合は指定されたデフォルト値が自動的に適用されます。

デフォルト引数の基本的な構文

def 関数名(引数名=デフォルト値):
    処理

この構文を使うことで、関数の引数を省略可能にし、コードの可読性や柔軟性を向上させることができます。

1.2 デフォルト引数の基本的な使い方

実際のコードを見ながら、Pythonのデフォルト引数の使い方を理解しましょう。

基本的な例

def greet(name="ゲスト"):
    print(f"こんにちは、{name}さん！")

greet()  # 出力: こんにちは、ゲストさん！
greet("佐藤")  # 出力: こんにちは、佐藤さん！

上記の関数greet()では、nameのデフォルト値を "ゲスト" に設定しています。関数を引数なしで呼び出した場合、name は "ゲスト" になります。一方、greet("佐藤") のように引数を指定すると、その値が優先されます。

複数のデフォルト引数を持つ関数

デフォルト引数は複数設定することもできます。

def introduce(name="匿名", age=20):
    print(f"私は{name}です。{age}歳です。")

introduce()  # 出力: 私は匿名です。20歳です。
introduce("田中")  # 出力: 私は田中です。20歳です。
introduce("田中", 25)  # 出力: 私は田中です。25歳です。

このように、複数の引数にデフォルト値を設定すると、関数の呼び出し方を柔軟に変えられます。

デフォルト引数を使うメリット

デフォルト引数を使うことで、次のようなメリットがあります。

• コードがシンプルになる（必須でない引数の省略が可能）
• エラーを防ぐ（引数の不足によるエラーを回避）
• 関数の汎用性が向上（デフォルト値を持たせることで、多様な使い方が可能）

1.3 デフォルト引数が活用される場面

デフォルト引数は、さまざまな場面で役立ちます。以下のようなケースでよく使われます。

1. オプションの設定

関数内でオプションの設定をデフォルト値として用意することで、ユーザーが変更可能な仕組みを簡単に作れます。

def download_file(url, timeout=10):
    print(f"{url} を {timeout} 秒以内にダウンロードします。")

download_file("https://example.com")  # 出力: https://example.com を 10 秒以内にダウンロードします。
download_file("https://example.com", 5)  # 出力: https://example.com を 5 秒以内にダウンロードします。

この場合、timeout にデフォルト値 10 を設定しているため、呼び出し時に指定しなければ 10 秒が適用されます。

2. ログメッセージの出力

関数を実行する際に、デフォルトのログメッセージを持たせることで、可読性の高いデバッグを実現できます。

def log_message(message, level="INFO"):
    print(f"[{level}] {message}")

log_message("処理を開始します")  # 出力: [INFO] 処理を開始します
log_message("エラーが発生しました", "ERROR")  # 出力: [ERROR] エラーが発生しました

この例では、level のデフォルト値を "INFO" に設定しており、特に指定がない場合は "INFO" としてログを記録します。

1.4 まとめ

Pythonのデフォルト引数は、関数を柔軟に設計するための便利な機能です。

• デフォルト引数を指定すると、引数を省略して関数を呼び出せる
• 複数のデフォルト引数を設定できる
• コードをシンプルにし、可読性や汎用性を向上させる
• オプションの設定やログ管理など、多くの場面で活用可能

次のセクションでは、Pythonのデフォルト引数を使用する際の注意点と、よくあるエラーについて解説します！

2. Pythonのデフォルト引数の基本的な使い方

前のセクションでは、Pythonのデフォルト引数の基本概念について解説しました。
このセクションでは、デフォルト引数を実際に活用する方法を、具体的なコード例を交えて詳しく説明します。

2.1 デフォルト引数を使った関数の定義

デフォルト引数を持つ関数は、以下のように定義できます。

def 関数名(引数1=デフォルト値1, 引数2=デフォルト値2, ...):
    処理

具体例

def greet(name="ゲスト", message="こんにちは"):
    print(f"{name}さん、{message}")

greet()  # 出力: ゲストさん、こんにちは
greet("佐藤")  # 出力: 佐藤さん、こんにちは
greet("佐藤", "お元気ですか？")  # 出力: 佐藤さん、お元気ですか？

このように、引数を省略した場合はデフォルト値が適用されますが、引数を指定するとその値が使われます。

2.2 デフォルト引数とキーワード引数の組み合わせ

関数を呼び出す際、キーワード引数（keyword arguments）を使うことで、より柔軟な指定が可能になります。

キーワード引数を利用した例

def introduce(name="匿名", age=20, country="日本"):
    print(f"私は{name}です。{age}歳で、{country}出身です。")

introduce()  # 出力: 私は匿名です。20歳で、日本出身です。
introduce(name="田中")  # 出力: 私は田中です。20歳で、日本出身です。
introduce(age=25, name="山本")  # 出力: 私は山本です。25歳で、日本出身です。
introduce(country="アメリカ", age=30)  # 出力: 私は匿名です。30歳で、アメリカ出身です。

➡ キーワード引数を使うことで、引数の順番を気にせずに関数を呼び出せるため、コードの可読性が向上します。

2.3 デフォルト引数の使いどころ

デフォルト引数を活用すると、特定のシナリオでコードを簡潔にできます。

① ログの記録

デフォルトのログレベルを設定することで、統一したログ管理が可能になります。

def log_message(message, level="INFO"):
    print(f"[{level}] {message}")

log_message("アプリケーションを開始")  
# 出力: [INFO] アプリケーションを開始

log_message("エラーが発生", "ERROR")  
# 出力: [ERROR] エラーが発生

② APIリクエストのパラメータ

APIを呼び出す際に、タイムアウト値をデフォルトで設定しておくことで、エラーの発生を防ぐことができます。

import requests

def fetch_data(url, timeout=10):
    response = requests.get(url, timeout=timeout)
    return response.json()

# デフォルトの10秒タイムアウト
data = fetch_data("https://api.example.com/data")

# タイムアウトを変更してリクエスト
data = fetch_data("https://api.example.com/data", timeout=5)

③ 計算処理の簡略化

デフォルト引数を使うと、計算処理をより柔軟に設計できます。

def calculate_price(price, tax_rate=0.10):
    return price * (1 + tax_rate)

print(calculate_price(1000))  # 出力: 1100.0（税率10%）
print(calculate_price(1000, 0.08))  # 出力: 1080.0（税率8%）

2.4 まとめ

• デフォルト引数を設定することで、関数の使いやすさが向上する
• キーワード引数を使うと、引数の順番を気にせずに呼び出せる
• ログ出力・APIリクエスト・計算処理など、実用的な場面で活用可能

3. デフォルト引数を使用する際の注意点【よくあるミスと対策】

Pythonのデフォルト引数は便利な機能ですが、誤った使い方をすると予期しないバグを引き起こすことがあります。
このセクションでは、デフォルト引数を使う際の注意点や、よくあるエラーとその対策について解説します。

3.1 デフォルト引数の順序に注意！

Pythonでは、デフォルト引数を持つ引数は、デフォルト引数を持たない引数の後に記述する必要があります。
順序を間違えると、SyntaxError（構文エラー）が発生します。

❌ 間違った例（エラー発生）

def func(x=0, y):  # エラー: デフォルト引数の後に非デフォルト引数は配置できない
    print(x, y)

➡ x=0 のデフォルト引数が y よりも前にあるため、Pythonは構文エラーを報告します。

✅ 正しい例

def func(y, x=0):  # OK
    print(x, y)

➡ デフォルトなしの引数（y）を先に記述することでエラーを回避できます。

3.2 可変オブジェクト（リスト・辞書）をデフォルト値にしない

デフォルト引数にリストや辞書などのミュータブル（変更可能）なオブジェクトを指定すると、意図しない動作を引き起こします。
Pythonでは、デフォルト引数の値は関数が定義された時点で1回だけ評価され、関数が呼び出されるたびに再利用されるためです。

❌ 間違った例（バグ発生）

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

print(add_item("apple"))  # 出力: ['apple']
print(add_item("banana"))  # 出力: ['apple', 'banana'] ← 予期しない動作！

➡ デフォルト引数として設定されたリスト item_list=[] が、関数を呼び出すたびに保持されるため、値が蓄積されてしまう。

✅ 正しい例

def add_item(item, item_list=None):
    if item_list is None:
        item_list = []  # 毎回新しいリストを作成
    item_list.append(item)
    return item_list

print(add_item("apple"))  # 出力: ['apple']
print(add_item("banana"))  # 出力: ['banana'] ← 期待通りの動作！

➡ デフォルト値に None を設定し、関数内で新しいリストを作成することで問題を回避。

3.3 デフォルト引数の評価タイミングに注意！

Pythonでは、デフォルト引数の値は、関数が定義された瞬間に評価されるため、時間依存の値をデフォルトに設定すると意図しない動作が発生することがあります。

❌ 間違った例（バグ発生）

import datetime

def log_message(message, timestamp=datetime.datetime.now()):
    print(f"[{timestamp}] {message}")

log_message("初回のログ")  
log_message("2回目のログ")  # 同じタイムスタンプが使われる！

➡ timestamp のデフォルト値 datetime.datetime.now() は、関数が定義された時点で評価され、全ての関数呼び出しで同じ値が使われる。

✅ 正しい例

import datetime

def log_message(message, timestamp=None):
    if timestamp is None:  # Noneなら現在の時刻を取得
        timestamp = datetime.datetime.now()
    print(f"[{timestamp}] {message}")

log_message("初回のログ")  
log_message("2回目のログ")  # 異なる時刻が適用される

➡ デフォルト値に None を設定し、関数内で datetime.datetime.now() を実行することで回避。

3.4 キーワード引数との組み合わせに注意！

デフォルト引数を持つ関数では、位置引数（positional arguments）とキーワード引数（keyword arguments）の組み合わせに注意が必要です。

❌ 間違った例（エラー発生）

def greet(name="ゲスト", message="こんにちは"):
    print(f"{name}さん、{message}")

greet("こんにちは", name="佐藤")  # TypeError: 位置引数とキーワード引数の重複

➡ "こんにちは" を name の位置引数として渡した後、 name="佐藤" を指定したため、エラーが発生。

✅ 正しい例

greet(name="佐藤", message="こんにちは")  # OK
greet("佐藤")  # OK

➡ 位置引数とキーワード引数を適切に使い分けることで回避。

3.5 まとめ

• デフォルト引数は、デフォルトなしの引数の後に記述する
• リストや辞書などのミュータブル（可変）なオブジェクトはデフォルト引数に使わない
• デフォルト引数の評価タイミングに注意し、時間依存のデータは None を使って回避
• 位置引数とキーワード引数の組み合わせを適切に扱う

4. デフォルト引数の評価タイミングとその影響

Pythonでは、デフォルト引数の値は関数が定義された時点で一度だけ評価され、その後は関数が呼び出されるたびに同じオブジェクトが再利用されます。
この特性を理解していないと、意図しないバグが発生する可能性があります。
ここでは、デフォルト引数の評価タイミングについて詳しく解説し、実際のコード例を交えて正しい使い方を紹介します。

4.1 デフォルト引数の評価タイミングとは？

通常、Pythonの変数は関数が呼び出されるたびに新しい値が設定されると思われがちですが、デフォルト引数は関数の定義時に一度だけ評価されるという点が大きく異なります。

評価タイミングの具体例

import datetime

def get_current_time(timestamp=datetime.datetime.now()):
    print(f"現在の時刻: {timestamp}")

get_current_time()  # 出力例: 現在の時刻: 2025-03-20 12:00:00
get_current_time()  # 出力例: 現在の時刻: 2025-03-20 12:00:00（同じ時刻！）

➡ この関数を複数回呼び出しても、同じ時刻が出力されることがわかります。
なぜなら、datetime.datetime.now() は関数が定義された時点で評価され、関数が呼び出されるたびにその時の値を再利用するためです。

4.2 デフォルト引数の評価タイミングによる問題点

この特性が原因で、次のようなバグが発生する可能性があります。

問題1：デフォルト引数に可変オブジェクト（リスト・辞書など）を設定すると、データが共有される

def append_to_list(value, my_list=[]):
    my_list.append(value)
    return my_list

print(append_to_list(1))  # 出力: [1]
print(append_to_list(2))  # 出力: [1, 2] ← 期待と異なる結果！
print(append_to_list(3))  # 出力: [1, 2, 3]

➡ 新しいリストが作成されるのではなく、前回の呼び出しのリストが再利用される。

問題2：辞書をデフォルト引数に設定した場合も同様の問題が発生

def add_to_dict(key, value, my_dict={}):
    my_dict[key] = value
    return my_dict

print(add_to_dict("a", 1))  # 出力: {'a': 1}
print(add_to_dict("b", 2))  # 出力: {'a': 1, 'b': 2} ← 期待と異なる！

➡ 関数を呼び出すたびに新しい辞書が作成されるのではなく、前回の辞書が再利用される。

4.3 デフォルト引数の評価タイミングによるバグを回避する方法

このような問題を防ぐために、デフォルト引数として None を指定し、関数内で新しいオブジェクトを作成するのがベストプラクティス です。

✅ 正しい書き方（回避策）

def append_to_list(value, my_list=None):
    if my_list is None:
        my_list = []  # 毎回新しいリストを作成
    my_list.append(value)
    return my_list

print(append_to_list(1))  # 出力: [1]
print(append_to_list(2))  # 出力: [2] ← 正しく動作
print(append_to_list(3))  # 出力: [3]

➡ None を使うことで、関数を呼び出すたびに新しいリストが作成されるため、バグを回避できる。

4.4 なぜ None を使うのがベストなのか？

Pythonでは、Noneはイミュータブル（変更不可）なオブジェクトであり、関数呼び出しごとに新しいオブジェクトを作成できるため、以下のような利点があります。

• デフォルト引数の共有問題を防ぐ
• 明示的な if 文を用いることで、コードの可読性が向上
• 関数内で適切なオブジェクトを動的に生成できる

辞書の場合の正しい書き方

def add_to_dict(key, value, my_dict=None):
    if my_dict is None:
        my_dict = {}  # 新しい辞書を作成
    my_dict[key] = value
    return my_dict

print(add_to_dict("a", 1))  # 出力: {'a': 1}
print(add_to_dict("b", 2))  # 出力: {'b': 2} ← 正しく動作

➡ 関数を呼び出すたびに新しい辞書が作成されるため、データの共有問題が発生しない。

4.5 まとめ

• Pythonのデフォルト引数は、関数定義時に1回だけ評価され、その後も再利用される
• デフォルト引数にミュータブルなオブジェクト（リスト・辞書など）を指定すると、データが共有されバグの原因になる
• 回避策として、デフォルト値を None にし、関数内で新しいオブジェクトを作成するのがベストプラクティス
• この知識を活用すれば、予期しないバグを防ぎ、より安全なコードが書ける

5. Pythonのデフォルト引数の実践的な活用法

これまでに、Pythonのデフォルト引数の基本的な使い方や注意点について解説してきました。
このセクションでは、実際の開発現場で役立つデフォルト引数の活用法を紹介します。
適切にデフォルト引数を使うことで、コードの可読性や保守性を向上させることができます。

5.1 デフォルト引数を活用した関数の設計

デフォルト引数は、関数の利便性を向上させるために活用されます。
以下のようなシナリオで特に有用です。

① 設定値を持つ関数

設定オプションがある関数では、デフォルト引数を使うことで柔軟な設計が可能になります。

def connect_to_database(host="localhost", port=3306, user="root", password=""):
    print(f"データベースに接続中: {host}:{port}, ユーザー: {user}")

connect_to_database()  
# 出力: データベースに接続中: localhost:3306, ユーザー: root

connect_to_database(host="db.example.com", user="admin")  
# 出力: データベースに接続中: db.example.com:3306, ユーザー: admin

➡ デフォルトの設定を用意することで、標準的なケースでは簡単に利用できる。

5.2 デフォルト引数を使うべき場面と避けるべき場面

✅ デフォルト引数を使うべき場面

1. 関数の引数がオプションである場合

• 例: 設定値 (port=3306, timeout=10)

1. 頻繁に使用するデフォルト値を提供したい場合

• 例: ログレベル (level="INFO")

1. 関数を簡潔にし、標準的な動作を定義したい場合

• 例: ユーザー名 (name="ゲスト")

❌ デフォルト引数を避けるべき場面

1. デフォルト値が可変オブジェクト（リストや辞書など）の場合

• ➡ None を使って適切に初期化する

1. 関数ごとに異なる値を持つべき場合

• 例: 現在時刻 (timestamp=datetime.datetime.now()) は None を使って評価のタイミングを調整

1. 引数の順序が重要な場合

• ➡ デフォルト値は最後に配置する

5.3 まとめ

• デフォルト引数を適切に使うと、コードの可読性と柔軟性が向上
• データベース接続・APIリクエスト・ロギング・ユーザー入力など、さまざまなシナリオで活用可能
• 可変オブジェクトをデフォルト引数にしない、引数の順序に注意するなどのルールを守る
• デフォルト引数を活用し、Pythonの関数をより実用的に設計しよう！

6. Pythonのデフォルト引数に関するよくある質問（FAQ）

これまでPythonのデフォルト引数について詳しく解説してきましたが、実際に使う際にはさまざまな疑問が出てくることがあります。
このセクションでは、デフォルト引数に関するよくある質問とその回答をまとめました。

6.1 デフォルト引数の基本に関する質問

Q1. デフォルト引数を持つ関数の引数の順序に制約はあるの？

A: はい、デフォルト引数を持つ引数は必ずデフォルトなしの引数の後に記述する必要があります。
順序を間違えると SyntaxError（構文エラー）が発生します。

❌ 間違った例（エラー）

def func(x=10, y):  # エラー: デフォルト値の後に非デフォルト引数がある
    print(x, y)

✅ 正しい例

def func(y, x=10):  # OK
    print(x, y)

➡ デフォルトなしの引数を先に記述するのがルールです。

6.2 可変オブジェクト（リスト・辞書）に関する質問

Q3. リストや辞書をデフォルト引数として設定するとバグが発生するのはなぜ？

A: Pythonではデフォルト引数の値が関数定義時に1回だけ評価され、その後も使い回されるため、リストや辞書のような可変オブジェクト（ミュータブルなオブジェクト）をデフォルト値にするとデータが共有されてしまうからです。

❌ バグが発生する例

def add_item(item, item_list=[]):  # 危険な書き方
    item_list.append(item)
    return item_list

print(add_item("apple"))  # 出力: ['apple']
print(add_item("banana"))  # 出力: ['apple', 'banana'] ← 意図しない動作！

✅ 正しい書き方（None を使う）

def add_item(item, item_list=None):
    if item_list is None:
        item_list = []  # 新しいリストを作成
    item_list.append(item)
    return item_list

print(add_item("apple"))  # 出力: ['apple']
print(add_item("banana"))  # 出力: ['banana'] ← 正しく動作！

➡ デフォルト値に None を使い、関数内で新しいオブジェクトを作成することで問題を回避できます。

6.3 その他のデフォルト引数に関する質問

Q5. デフォルト引数の評価タイミングはいつ？

A: デフォルト引数の値は、関数が「定義された時点」で1回だけ評価されます。
そのため、関数を呼び出すたびに異なる値を期待する場合には注意が必要です。

❌ 問題が発生する例

import datetime

def log_message(message, timestamp=datetime.datetime.now()):
    print(f"[{timestamp}] {message}")

log_message("初回のログ")  
log_message("2回目のログ")  # 同じタイムスタンプが出力される！

✅ 正しい書き方

def log_message(message, timestamp=None):
    if timestamp is None:
        timestamp = datetime.datetime.now()  # 呼び出し時に評価
    print(f"[{timestamp}] {message}")

log_message("初回のログ")  
log_message("2回目のログ")  # 異なる時刻が出力される！

➡ デフォルト値に None を使い、関数内で適切なタイミングで値を取得するのが正しい方法です。

6.4 まとめ

• デフォルト引数は、デフォルトなしの引数の後に記述する必要がある
• キーワード引数を使うことで、引数の順番を気にせずに呼び出せる
• 可変オブジェクト（リスト・辞書）をデフォルト引数にするとバグが発生するので None を使うのがベスト
• デフォルト引数の評価タイミングに注意し、datetime.now() などの値は None を使って遅延評価する
• デフォルト引数に関数を渡すことも可能で、動的な処理を実装できる

7. まとめと次のステップ

ここまで、Pythonのデフォルト引数について詳しく解説しました。
デフォルト引数を適切に使うことで、コードの可読性や柔軟性が向上し、バグの発生を防ぐことができます。

次のステップとして：

• 実際にデフォルト引数を活用した関数を作成し、挙動を確認する
• None を使ったデフォルト値の設定を実践する
• キーワード引数とデフォルト引数を組み合わせた設計を試す

Pythonのデフォルト引数をマスターして、より効率的でバグのないコードを書けるようになりましょう！ 🚀